如何将 MCP 连接器(MCP 服务器)添加到 Tesseract

Tesseract 支持通过 stdio、HTTP 或 SSE 连接的任意 MCP 服务器,也支持官方 MCP 注册表中的服务器。前往“设置”→“扩展”→“连接器”,通过服务器地址、启动命令或 JSON 格式的设置添加一次即可。之后,Tesseract 中的 14 种智能体框架都可以使用它提供的工具。

已针对 Tesseract 0.12.5 完成核对。

如何将 MCP 服务器添加到 Tesseract?

打开“设置”→“扩展”→“连接器”,然后用以下三种方式之一提供服务器信息。添加前,Tesseract 会显示服务器信息供您查看。

  1. 打开 “设置”→“扩展”,然后切换到 “连接器” 标签页。
  2. 在顶部的输入框中粘贴以下任意一种内容,然后点击 “添加”:
    • 服务器地址,用于网络上的服务器:例如 https://mcp.example.com/mcp 这样的 http(s) 链接。
    • 命令,用于通过 stdio 在本机运行的服务器,例如 npx -y @acme/notes-mcp。
    • 其 JSON 格式的设置:命令、参数和环境。
  3. 查看 Tesseract 显示的信息。对于命令,可以查看将要运行的完整命令;获准前不会运行任何内容。
  4. 点击底部的按钮添加:命令对应 “允许并添加”,地址对应 “添加连接器”。点击按钮后才会添加。

我可以粘贴 JSON 配置吗?例如服务器 README 中的配置。

可以。Tesseract 可以读取单个服务器的设置(包含 url 或 command),也可以读取 mcpServers 下的整个配置块。它还可以识别 servers、mcp 或 mcp_servers 下的服务器。

例如,以下是一个在您电脑上运行的服务器:

{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }

如果设置中包含多个服务器,Tesseract 会逐一列出,您可以选择要添加的服务器。

如何从官方 MCP 注册表添加服务器?

在“连接器”选项卡中,点击输入框旁的 浏览目录,然后从目录中添加服务器。

  1. 打开 “设置”→“扩展”→“连接器”。
  2. 点击 “浏览目录”。这里会列出官方 MCP 注册表中的服务器,您可以按名称搜索。
  3. 点击你想要的那个上的 “添加”。接下来会看到与粘贴地址或命令相同的步骤,在你同意之前不会添加任何内容。

它支持 Claude Code、Codex、Gemini CLI 和 OpenCode 吗?

支持。此网站上所有 14 种框架的介绍页都将“Tesseract 工具和您的 MCP 服务器”列为支持内容。这包括 Claude Code、OpenAI Codex、OpenCode、Gemini CLI、Antigravity CLI、Kimi Code、Qwen Code、MiniMax Code、CodeBuddy、Grok Build、Cursor、Hermes Agent、OpenClaw 和 NanoClaw。只需在 Tesseract 中添加一次连接器,无需为每种框架分别添加。每个对话都可以选择自己的框架,因此不同对话可以使用不同框架。

如何为我的连接器制作“添加到 Tesseract”按钮?

使用免费的生成器 tesseract.dev/connect/。它会生成适用于 README 的 Markdown 徽章和普通链接。

  1. 打开 tesseract.dev/connect/。
  2. 输入连接器名称。
  3. 粘贴服务器地址或 JSON 格式的设置。
  4. 将 Markdown 复制到 README 中,或复制链接。

徽章会链接到 tesseract.dev 页面,而不是直接打开应用,因为 GitHub 会移除非 http(s) 链接。地址最多可有 2,048 个字符。设置必须是一个不超过 20,000 个字符的 JSON 对象。设置会直接写入链接,只经过编码(base64url),因此请勿在其中放入真实密钥和令牌。

有人点击按钮后会发生什么?

对方会先在 tesseract.dev 上看到你的连接器,不会自动打开任何内容。

  1. 页面会说明连接器是什么:它访问的网址或运行的命令,都会完整列出。
  2. 页面会提供 在 Tesseract 中打开,以及供尚未安装应用的人使用的 获取 Tesseract。
  3. 点击“在 Tesseract 中打开”后,会打开“设置 → 扩展 → 连接器”,并在输入框中填入连接器,同时标记为“此内容来自链接”。
  4. 添加任何内容前,Tesseract 都会再次显示;运行任何内容前,也会先征求确认。

如果链接中的 url= 或 config= 无法读取,页面会显示“此链接未指定连接器”。

这和在 Claude 或 ChatGPT 中使用 Tesseract 一样吗?

不一样。本指南介绍如何将其他 MCP 服务器添加到 Tesseract;在 Claude 和 ChatGPT 中使用 Tesseract 则相反,是通过一个地址将 Tesseract 添加到聊天应用中。

常见问题

Tesseract 能使用任何 MCP 服务器吗?

它支持通过 stdio、HTTP 或 SSE 接入任何 MCP 服务器。

我需要分别为 Claude Code 和 Codex 设置服务器吗?

不需要。在“设置 → 扩展 → 连接器”中添加一次,Tesseract 中的所有框架都可以使用。

可以粘贴 README 中的 mcpServers JSON 吗?

可以。Tesseract 可以读取单个服务器的设置,也可以读取整个 mcpServers 配置块。

在哪里可以找到 MCP 官方注册表中的服务器?

在“设置 → 扩展 → 连接器”中,“浏览目录”下。

“添加到 Tesseract”链接会自动添加连接器吗?

不会。添加任何内容前,Tesseract 都会再次向你展示;运行任何内容前,也会先征求你的同意。

更多指南