快速开始

通过 MCP 接入 agent、授权，并用一次真实的工具调用验证连接。

最快的方式：给 agent 一行话，让它自己完成设置。

set up https://service.opennomos.com/SKILL.md

这个文件里有各个宿主的命令、OAuth 步骤和下面的验证调用。你只需要登录并授权。本页其余内容是同一套流程的人类版。

1. 添加 MCP 服务

端点是 https://mcp.opennomos.com/mcp（无状态 Streamable HTTP,OAuth）。

claude mcp get opennomos || claude mcp add --transport http opennomos https://mcp.opennomos.com/mcp

然后在 Claude Code 里运行 /mcp，选择 OpenNomos，在浏览器里完成认证。

浏览器会打开登录页（邮箱验证码）和授权页，你在授权页选择工作区。凭据由客户端保存，这条路径下不需要你创建或粘贴 API 密钥。

OpenNomos 支持动态客户端注册（DCR）。托管服务没有启用 Client ID Metadata Documents（CIMD），所以只提供 CIMD 的宿主需要改用 DCR 模式。

让 agent 用 {} 调用 discover_tools:

{ "tools": [{ "name": "discover_tools", "summary": "…" }, "…"], "sources": { "web": true, "reddit": true }, "source_endpoints": { } }

调用成功，说明连接确实通到了你的工作区。它用的是 Core 工具包，不调用任何付费服务商，不创建项目，也不写入记忆。只保存了服务器 URL 不算设置成功：如果宿主需要重新加载才会显示新工具，请重新加载后再调用一次。

{ "query": "alternatives to Notion", "sources": ["reddit", "web"], "limit": 5 }

把它传给 search_signals。你会拿到来源条目，什么都不会被保存。想留下某些内容时，见记忆与机会。

不支持 OAuth 的宿主可以用控制台创建的密钥（on_live_…；只显示一次，服务端只存哈希）。把它放在宿主的凭据库或环境变量里：

curl --fail-with-body https://service.opennomos.com/v1/tools \
  -H "Authorization: Bearer $OPENNOMOS_API_KEY"

现象	怎么办
`401`	完成 OAuth，或更换无效的密钥。被撤销的连接需要重新授权。
`pack_required`	该工具需要的工具包没有启用；响应里带有控制台 URL。
`soft_limit`	该工具包的每月上游成本上限已用完。
带 `reason` 和 `action` 的结果	某个上游来源出了问题。见错误。