DoiT MCP Server

DoiT MCP Server

DoiT MCP Server 提供对 DoiT API 的访问。此服务让 Claude 等大模型能够访问 DoiT 平台数据，以进行故障排查和分析。

身份验证

身份验证方式取决于连接方法：

方法	URL / 命令	身份验证
远程（Streamable HTTP）	https://mcp.doit.com/mcp	OAuth — 客户端会打开 DoiT 登录和授权页面。无头客户端也可以发送客户个人 API 令牌，并将其作为 Authorization: Bearer。
本地（stdio）	npx -y @doitintl/doit-mcp-server@latest	通过 DOIT_API_KEY 使用个人 API 令牌。

旧版 SSE 端点（https://mcp.doit.com/sse）已弃用，不应用于新的配置。

你的 DoiT 套餐必须包含 API 访问权限。工具遵循与 DoiT API 相同的权限。

工具结果在响应格式化后，最多包含 140,000 个序列化 UTF-16 代码单元，其中包括结构化内容和元数据。超出大小限制的读取会返回可采取行动的错误；已完成的写入会返回简洁的成功回执，不应仅为获取其输出而重复执行。错误仍会作为错误返回。这是响应大小策略，不是令牌限制，也不限制上游下载。

每次分发调用都会通过 stdio 向 stderr 输出不含载荷的 JSON mcp_tool_response 事件；某些客户端会显示这些日志。宿主可以提供 onResponseMetrics，将事件路由到其他位置。使用 original.serializedChars 计算响应大小百分位数，使用 exceededLimit 计算超限率；returned 表示经过保护机制处理后的结果。指标还包括 UTF-8 字节数、持续时间、工具/客户端和处置方式，不包含工具参数或响应正文。

下面的 Claude Desktop 步骤仅为示例，并非唯一受支持的客户端。Cursor、VS Code、Amazon Q、Claude Code 等客户端的说明，请参阅连接指南。

远程（Streamable HTTP）

以 Claude Desktop 为例：添加自定义连接器（+ → 添加连接器 → 添加自定义连接器），并将远程 MCP 服务 URL 设置为 https://mcp.doit.com/mcp。出现提示时，完成 DoiT 登录。

无头客户端（API 令牌）

无法打开浏览器的 Agent（例如集群中的 HolmesGPT、CI 作业、cron 工作进程）可以使用客户个人 API 令牌，通过 bearer 标头向同一端点进行身份验证。工具使用该令牌的权限运行，与 stdio 方式完全相同。远程端点不接受 DoiT 员工令牌；员工应使用 OAuth 或本地服务。

以 HolmesGPT 为例：

mcp_servers:
  doit:
    description: "DoiT Cloud Intelligence"
    config:
      url: "https://mcp.doit.com/mcp"
      mode: streamable-http
      headers:
        Authorization: "Bearer {{ env.DOIT_API_KEY }}"
      health_check_tool: "validate_user"

请将令牌保存在密钥存储中，并按计划轮换。设计说明：docs/remote-api-key-bearer-auth.md。

本地（stdio）

支持兼容客户端使用 MCP Skills。默认不捆绑任何 Skills。

需要 Node.js v20 或更高版本，以及通过 DOIT_API_KEY 提供的个人 API 令牌。请在 DoiT 控制台的个人 API 令牌页面创建令牌。

以 Claude Desktop 为例——将以下内容添加到 claude_desktop_config.json（或“设置”），然后重启 Claude：

{
  "mcpServers": {
    "doit_mcp_server": {
      "command": "npx",
      "args": ["-y", "@doitintl/doit-mcp-server@latest"],
      "env": {
        "DOIT_API_KEY": "your_doit_api_key"
      }
    }
  }
}

• DOIT_API_KEY：你的 DoiT API 令牌（必填）
• CUSTOMER_CONTEXT：客户上下文标识符（可选）

支持的 MCP 协议版本

stdio 服务无需任何配置即可与两个 MCP 协议时期的客户端配合使用：

• 2024-10-07 至 2025-11-25，通过 initialize 握手。
• 2026-07-28，通过 server/discover。

每个连接的起始消息会决定它使用哪个时期。有关详情及验证兼容性的测试，请参阅 docs/protocol-compatibility.md。

克隆到本地仓库

如果你想直接从源代码克隆并运行此 MCP 服务，请按以下步骤操作：

1. 克隆仓库

git clone https://github.com/doitintl/doit-mcp-server
cd doit-mcp-server

2. 安装依赖项

yarn install

3. 构建项目

yarn build

4. 运行服务

DOIT_API_KEY=your_doit_api_key node dist/index.js

核心包 API

提供自有 MCP 传输方式的应用可以复用已发布的、与传输方式无关的实现：

npm install @doitintl/doit-mcp-server@latest

import {
    COVERED_ENDPOINTS,
    executeToolHandler,
    generateTools,
    generatedToolsOpenApiSpec,
    HAND_WRITTEN_TOOLS,
} from "@doitintl/doit-mcp-server/core";

/core 入口包含工具和提示词定义、生成工具实用程序、请求处理以及共享配置 API。它不会初始化 stdio 传输，也不包含 Cloudflare Worker、OAuth、Durable Objects 或 widget 实现。

使用示例

以下是使用 DoiT MCP 服务时可以提出的一些常见问题：

成本分析与节省

• “我的 Flexsave 节省了多少？”——这将分析你在各个云账户中的 Flexsave 成本优化节省情况。
• “按成本计算，排名前 3 的 AWS 服务是什么？”——这将运行 Cloud Analytics 查询，找出支出最高的 AWS 服务。

报告与分析

• “列出我可用的所有报告”——这将显示你有权访问的所有 Cloud Analytics 报告。
• “显示‘Monthly Cost Overview’报告的结果”——这将获取并显示指定报告的结果。

异常检测

• “我最近有哪些 GCP 异常？”——这将显示在你的 Google Cloud Platform 账户中检测到的近期成本或用量异常。
• “显示异常 ABC123 的详细信息”——这将提供指定异常的详细信息。

发票

• “列出我的所有发票”——这将显示你所在组织当前和历史的所有发票。
• “显示发票 INV-2024-001 的详细信息”——这将提供指定发票的完整信息，包括明细项目和付款状态。

这些示例展示了基本的使用模式。你可以根据需要组合和修改这些问题。MCP 服务会理解你的自然语言问题，并使用合适的工具获取所请求的信息。

环境变量

供本地 stdio 服务使用。远程 /mcp 连接通过 OAuth 进行身份验证。

• DOIT_API_KEY：你的 DoiT 个人 API 令牌（stdio 必需）
• CUSTOMER_CONTEXT：你的客户上下文标识符（可选）