VS Code、Cursor 及其他 MCP 客户端

聚易可与任何支持通过 Streamable HTTP 连接远程服务器并支持 OAuth 登录的 MCP 客户端配合使用。服务器地址是：

https://gathereasy.rsvp/api/mcp

在工作区中创建或打开 .vscode/mcp.json（或在命令面板中运行 MCP: Open User Configuration，为所有工作区添加），并加入：

{
  "servers": {
    "gathereasy": {
      "type": "http",
      "url": "https://gathereasy.rsvp/api/mcp"
    }
  }
}

点击服务器条目上方的 Start。VS Code 会请求登录聚易，允许后在浏览器中登录并点击允许访问。之后在 Copilot Chat 的 Agent 模式中使用聚易。

也可以在命令面板中运行 MCP: Add Server，选择 HTTP 并粘贴地址。

打开 Cursor Settings → MCP → Add new MCP server，或编辑 ~/.cursor/mcp.json，加入：

{
  "mcpServers": {
    "gathereasy": {
      "url": "https://gathereasy.rsvp/api/mcp"
    }
  }
}

在 Cursor Settings → MCP 中，聚易会提示需要登录。点击它打开聚易登录页面，然后点击允许访问。

大多数接受 mcpServers 配置的客户端使用类似格式：

{
  "mcpServers": {
    "gathereasy": {
      "type": "http",
      "url": "https://gathereasy.rsvp/api/mcp"
    }
  }
}

不同客户端的字段名可能不同（url、serverUrl 或 httpUrl；http 或 streamable-http）。请在客户端文档中查找“remote MCP server”。

客户端需要支持的功能

要登录，客户端必须支持 MCP 的标准 OAuth 流程：

要显示聚易的交互式面板，还需要支持 MCP Apps 扩展。不支持的客户端会以文字形式获得相同结果。

不支持登录的客户端仍可使用公开的发现功能（例如搜索活动和场地），但无法进行任何需要账户的操作。

如果你的客户端只能启动本地（stdio）MCP 服务器，可以使用开源桥接工具 mcp-remote，它会帮你完成浏览器登录。需要安装 Node.js：

{
  "mcpServers": {
    "gathereasy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gathereasy.rsvp/api/mcp"]
    }
  }
}

除了工具，聚易还提供：

提示词：现成的起点。参见现成的提示词。
资源，客户端可以把它们附加到对话中：gathereasy://events/{event_id}、gathereasy://events/{event_id}/calendar.ics、gathereasy://venues/{venue_id} 和 gathereasy://groups/{group_id}。活动、社群和场地 ID 会自动补全，优先显示你自己的活动和社群。