nessie

连接 ChatGPT、Claude 及其他 AI 应用

将 Nessie 添加到 ChatGPT、Claude、Claude Code 或任意 MCP 客户端,并选择它可以以你的身份做什么。

地址

每个 AI 应用都通过同一个地址连接 Nessie:

https://nessie.works/mcp

它们只需要这一个地址。登录、注册应用以及选择应用可以执行的操作,全部在 Nessie 中完成,并会在一个页面上显示应用名称以及完成后将返回的位置。你无需复制任何密钥或令牌。

https://api.nessie.works/mcp 是同一台服务器的 API 地址,即 Nessie 在 Settings › Security 下显示的那个地址;两者均可使用。如果是你自己运行 Nessie,请使用你自己的 API 地址,并在末尾加上 /mcp。

ChatGPT

  1. 打开 ChatGPT Plugins,点击加号按钮,然后选择 Add custom MCP server。
  2. 将其命名为 Nessie,然后在 Connection 下填入 https://nessie.works/mcp。
  3. 身份验证方式选择 OAuth。ChatGPT 会自动在 Nessie 中注册自己,无需填写其他任何内容。
  4. 确认关于自定义服务器的提示,然后点击 Create as a plugin。
  5. ChatGPT 会打开 Nessie。如被要求,请登录,选择它可以执行的操作,然后点击 Allow。

能否添加自定义服务器,取决于你的 ChatGPT 套餐;如果是在企业工作区中,则取决于管理员允许的范围。OpenAI 会不时调整这些设置。如果你看到的界面不同,请使用上面的地址,并按照 OpenAI 的最新步骤操作。

Claude

在 claude.ai、桌面应用或移动应用中:

  1. 进入 Customize › Connectors,然后选择 Add custom connector。
  2. 在服务器 URL 中填入 https://nessie.works/mcp。OAuth 客户端 ID 和密钥留空。
  3. 如果 Claude 询问应以何种方式进行身份标识,请选择 Register automatically。
  4. 选择 Connect。Claude 会打开 Nessie,你可在此选择它可以执行的操作,然后点击 Allow。

在 Team 或 Enterprise 套餐中,所有者只需在 Organization settings › Connectors 下添加一次连接器,然后每位成员分别使用自己的 Nessie 账户进行连接。Anthropic 的指南:添加目录中没有的连接器。

Claude Code

claude mcp add --transport http nessie https://nessie.works/mcp

然后在会话中运行 /mcp,选择进行身份验证;Claude Code 会打开你的浏览器。请勿自行添加 Authorization 请求头。

Codex

codex mcp add nessie --url https://nessie.works/mcp
codex mcp login nessie

其他 MCP 客户端

Nessie 支持 streamable HTTP 以及 MCP 授权规范:采用 PKCE(S256)的 OAuth 2.1、动态客户端注册、刷新令牌和资源指示器。支持 OAuth 远程服务器的客户端只需要这个地址。无法打开浏览器的命令行智能体则改用短代码进行配对;参见 MCP 与已连接工具。

连接时由你决定的事项

该应用以你的身份在 Nessie 中工作,且只能访问你自己能够访问的内容。在授权页面上,你可以选择:

  • 它可以执行的操作。读取和修改看板,读取文档并以草稿形式撰写,读取 Clients,在 Clients 中开展工作,给客户发消息,以及操作你团队的网站。除非你主动开启,否则默认不允许给客户发消息和操作网站。发布文档从来不是一项权限:应用只能发出请求,每一次发布都需要你逐一批准。
  • 哪些团队。你所在的团队,以及你在组织中勾选的其他任何团队。应用一次只在一个团队中工作,并且绝不会在团队之间移动任何内容。

连接的有效期为 90 天。之后请重新连接该应用。

它能做什么

  • 工单:查找项目和看板,创建、编辑和移动工单,发表评论,添加附件,以及管理标签、工单类型和检查清单。
  • 文档:读取你的知识空间,起草和编辑文档与电子表格,并请求你发布其中一份。
  • Clients:阅读并处理邮件、短信、Facebook、Instagram 和网站聊天中的客户收件箱;维护联系人和联系人名单;准备电子报营销活动(须由人工发送);以及读取联系表单提交内容。

可以这样开始对话:“列出我的 Nessie 项目”。

查看并断开你已连接的应用

每个已连接的应用都会列在 Nessie 的 Settings › Security › Programs signed in as you 中,并显示其可执行的操作、可访问的团队以及最近一次使用时间。点击撤销即可立即结束连接。组织所有者可以看到组织中的全部连接,并可在 Admin › Security › Programs signed in as people 下完全关闭连接功能。

如果出现问题

  • “Connect Nessie again.”可能是 90 天有效期已到、连接已被撤销,或者你已在所有地方退出登录。请先在应用中移除 Nessie,然后重新添加。
  • “This connection request has expired or was already answered.”授权页面只等待十分钟。请从应用中重新开始连接。
  • 工具提示缺少权限。你在授权应用时没有勾选该权限。请撤销连接,然后重新连接并勾选该权限。
  • “This connection can no longer reach the team…”你已离开该团队。此连接的其他团队仍可正常使用;如需重新加入该团队,请再次连接。

供自动发现服务器的智能体和工具使用

Nessie 发布了智能体会查找的标准文档:

  • https://nessie.works/.well-known/ai-catalog.json 和 https://api.nessie.works/.well-known/ai-catalog.json —— AI Catalog,其中指向位于 https://api.nessie.works/mcp/server-card 的服务器卡片(MCP Server Cards,SEP-2127)。
  • https://api.nessie.works/.well-known/oauth-protected-resource 和 https://api.nessie.works/.well-known/oauth-authorization-server —— 说明如何登录(RFC 9728 和 RFC 8414)。对 MCP 端点的未认证调用会指向前者。
  • 官方 MCP Registry 中的 works.nessie/nessie。
  • https://nessie.works/llms.txt —— 本页及其余全部文档,供语言模型读取。