Stape MCP Server

自定义连接器（直接使用 HTTP）。 如果你的添加自定义连接器对话框中有请求标头部分（该功能目前处于测试阶段，尚未向所有组织开放）：

1. 前往自定义 → 连接器 → 添加自定义连接器。对于 Team 和 Enterprise 方案，应由所有者在组织设置 → 连接器中添加；之后，每位成员都会使用所有者填写的密钥：组织中的所有人都将以同一个 Stape 账户的身份操作，包括使用其写入和删除工具，因此仅在符合预期时才这样设置。
2. 将 URL 设为 https://mcp.stape.io/mcp，并将身份验证设为无需登录。
3. 在请求标头下，添加 authorization，并将你的 Stape API 密钥设为其值，勾选必填，然后选择添加。

该连接器也可在 claude.ai 上使用。EU 账户请将 URL 设为 https://mcp.stape.io/mcp?region=eu。

mcp-remote。 如果没有请求标头部分，请将以下内容添加到你的 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "stape-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.stape.io/mcp",
        "--header",
        "Authorization: ${your_stape_api_key}"
      ]
    }
  }
}

EU 账户：在 args 中添加 "--header", "X-Stape-Region: EU"。

claude mcp add --transport http stape-mcp-server https://mcp.stape.io/mcp \
  --header "Authorization: ${your_stape_api_key}"

这只会将服务添加到当前项目。添加 --scope user 可在每个项目中使用它；添加 --scope project 则会将其写入项目的 .mcp.json（如果该文件已提交，请勿使用后一种方式，因为其中包含你的密钥）。在 Claude Code 中运行 claude mcp list 或 /mcp，确认连接成功。

EU 账户：添加 --header "X-Stape-Region: EU"。

VS Code 的 MCP 客户端原生支持 HTTP 服务，无需使用 mcp-remote。将以下内容添加到 .vscode/mcp.json（当前工作区），或添加到通过MCP: 打开用户配置打开的文件中（适用于每个工作区）。服务首次启动时，VS Code 会提示输入 API 密钥并将其保存，因此密钥不会写入文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "stape-api-key",
      "description": "Stape API key",
      "password": true
    }
  ],
  "servers": {
    "stape-mcp-server": {
      "type": "http",
      "url": "https://mcp.stape.io/mcp",
      "headers": {
        "Authorization": "${input:stape-api-key}"
      }
    }
  }
}

EU 账户：在 headers 中添加 "X-Stape-Region": "EU"。

copilot mcp add --transport http stape-mcp-server https://mcp.stape.io/mcp \
  --header "Authorization: ${your_stape_api_key}"

这会将服务条目写入 ~/.copilot/mcp-config.json，并立即生效。运行 copilot mcp get stape-mcp-server 确认连接成功。在交互式会话中，/mcp add 也可以通过表单完成相同操作。更多信息请参阅 GitHub 的文档。

欧盟账户：添加 --header "X-Stape-Region: EU"。

VS Code 中的 GitHub Copilot Chat 使用 VS Code 自带的 MCP 客户端，因此会读取同一个 .vscode/mcp.json 文件——请参阅上文的 VS Code，其中也包括欧盟地区的修改。无需单独配置。

Cursor 也可以直接使用 HTTP，无需 mcp-remote。将以下内容添加到 .cursor/mcp.json（当前项目）或 ~/.cursor/mcp.json（所有项目）：

{
  "mcpServers": {
    "stape-mcp-server": {
      "url": "https://mcp.stape.io/mcp",
      "headers": {
        "Authorization": "${your_stape_api_key}"
      }
    }
  }
}

若要避免密钥写入文件，可设置 "Authorization": "${env:STAPE_API_KEY}"，并在 shell 配置文件中导出 STAPE_API_KEY。在 Cursor 侧边栏的 自定义 中管理服务。

欧盟账户：在 headers 中添加 "X-Stape-Region": "EU"。

Antigravity 也可以直接使用 HTTP，但使用的是 serverUrl，而不是 url。将以下内容添加到 ~/.gemini/config/mcp_config.json，Antigravity 编辑器和 CLI 共用此文件。在编辑器中，可通过 Agent 面板中的 … → MCP Servers → Manage MCP Servers → View raw config 打开此文件：

{
  "mcpServers": {
    "stape-mcp-server": {
      "serverUrl": "https://mcp.stape.io/mcp",
      "headers": {
        "Authorization": "${your_stape_api_key}"
      }
    }
  }
}

欧盟账户：在 headers 中添加 "X-Stape-Region": "EU"。

ChatGPT 目前还无法连接到 Stape MCP 服务。其自定义 MCP 服务（Plugins → + → Add custom MCP server）仅支持 OAuth 或无身份验证（OpenAI 的文档），而 Stape MCP 服务使用 API 密钥进行身份验证。暂时请使用其他客户端。

1. 在 Lovable 中，前往 连接器，选择右上角的 +，然后选择 MCP 服务。
2. 将 服务名称 设置为 Stape，并将 服务 URL 设置为 https://mcp.stape.io/mcp。
3. 在身份验证选项中，选择 Bearer token or API key（而非默认的 OAuth），然后粘贴你的 Stape API 密钥。
4. 选择 添加服务。

Lovable 无法发送自定义请求头，因此欧盟账户应将 https://mcp.stape.io/mcp?region=eu 用作服务 URL，而不是使用 X-Stape-Region 请求头。此连接仅供个人使用（团队成员需各自添加），可用于项目聊天和 Chats，但不能用于已发布的应用。更多信息请参阅 Lovable 的文档。

如果你的客户端支持带自定义请求头的远程 HTTP MCP 服务，请将其指向 https://mcp.stape.io/mcp，并在 Authorization 请求头中填入你的 Stape API 密钥，配置示例见 Cursor。否则，请使用 mcp-remote：

{
  "mcpServers": {
    "stape-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.stape.io/mcp",
        "--header",
        "Authorization: ${your_stape_api_key}"
      ]
    }
  }
}

欧盟账户：发送 X-Stape-Region: EU 请求头（使用 mcp-remote 时，在 args 中添加 "--header", "X-Stape-Region: EU"），或者，如果客户端只接受 URL 和密钥，则使用 https://mcp.stape.io/mcp?region=eu。