连接 AI 客户端¶

连接只需要两条信息和一次配置修改。本页介绍两种传输方式：Claude Code、Cursor、Windsurf 和 Cline 使用 SSE，Codex CLI 使用 Streamable HTTP。

开始之前¶

1. 确认服务器地址。 把下面示例中的 your-specivo-host 替换成你实际的 Specivo 主机名（例如 specivo.example.com）。
2. 准备一个 API 密钥。 如果还没有，在 个人资料 → API 密钥 中创建一个，详见 API 密钥与作用域。各示例中的 spv_your_api_key_here 只是占位符，请换成你真实的 spv_… 密钥。

添加配置¶

两个端点提供的工具完全相同，按你的客户端选择对应的标签页即可。

{
  "mcpServers": {
    "specivo": {
      "type": "sse",
      "url": "https://your-specivo-host/mcp/sse/",
      "headers": { "Authorization": "Bearer spv_your_api_key_here" }
    }
  }
}

[mcp_servers.specivo]
url = "https://your-specivo-host/mcp/"
bearer_token_env_var = "SPECIVO_API_KEY"

export SPECIVO_API_KEY=spv_your_api_key_here

验证连接¶

客户端重新加载后，应该能发现 specivo_… 系列工具。让智能体运行 specivo_whoami，它会返回密钥所属的用户，既确认连接成功，也确认智能体是以哪个账户在操作。