跳转到内容

连接 Cursor 及其他客户端

每个 GPT Workspace 服务器都通过带有 OAuth 2.0 的流式 HTTP 进行通信,因此任何支持远程 MCP 服务器的客户端都可以使用它。唯一需要配置的就是 URL;客户端会自动发现 OAuth 端点,并在首次使用时打开 Google 的登录页面。

打开 Cursor Settings ➤ MCP,点击 Add new global MCP server,或者编辑 ~/.cursor/mcp.json(全局)或项目中的 .cursor/mcp.json:

{
"mcpServers": {
"google-sheets": {
"url": "https://api.gpt.space/servers/google-sheets/mcp"
},
"gmail": {
"url": "https://api.gpt.space/servers/gmail/mcp"
}
}
}

保存后,在 MCP 设置中点击服务器旁边的 Connect 或登录链接。通过 Google 的授权页面后,工具会显示并带有绿色圆点。

在命令面板中运行 MCP: Add Server,选择 HTTP,粘贴 URL 和名称。或者添加到 .vscode/mcp.json:

{
"servers": {
"google-docs": {
"type": "http",
"url": "https://api.gpt.space/servers/google-docs/mcp"
}
}
}

点击服务器旁边的 Start,然后在提示时使用 Google 登录。

使用相同的结构:一个包含 url 的服务器条目(某些客户端将该字段称为 serverUrl,或需要 "type": "streamable-http")。请查阅您所用客户端的文档以确认具体的键名。

某些客户端只能运行本地命令。可以使用 mcp-remote 来桥接远程服务器,它会在您的浏览器中处理 OAuth 流程并保存令牌:

{
"mcpServers": {
"google-drive": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.gpt.space/servers/google-drive/mcp"]
}
}
}

使用任何支持流式 HTTP 传输和 OAuth 客户端提供程序的 MCP SDK。服务器在以下地址暴露其元数据:

  • https://api.gpt.space/.well-known/oauth-protected-resource/servers/<name>/mcp
  • https://api.gpt.space/.well-known/oauth-authorization-server/servers/<name>/mcp

支持动态客户端注册,因此您的 agent 不需要预先注册的客户端 ID。没有有效令牌的请求会收到 401 响应,其中包含指向上述元数据的 WWW-Authenticate 头。