DoiT MCP 服务器
DoiT MCP 软件 服务器提供访问DoiT API的功能. 这个服务器可以让克洛德这样的LLMs访问多伊T平台数据进行故障排除和分析.
认证
如何认证取决于连接方法 :
| 方法 | URL / 命令 | 认证 |
|---|---|---|
| 远程( Streamable HTTP) | https://mcp.doit.com/mcp | OAuth — 您的客户端打开了 DoiT 签名和同意页 。 无头客户端可以发送客户个人 API 令牌作为 Authorization: Bearer。 。 。 . |
| 当地( stdio) | npx -y @doitintl/doit-mcp-server@latest | 个人 API 令牌通过 DOIT_API_KEY。 。 。 . |
遗留的SSE 终点( :https://mcp.doit.com/sse)已贬值,不应用于新设置.
您的 DoiT 计划必须包含 API 访问 。 工具跟随相同的权限 Doit API (英语)。 。 。 .
工具结果上限为140 000个响应后序列化的UTF-16代码单元 格式化,包括结构化内容和元数据. 超大小读取返回 a 可操作错误; 已完成的写入返回压缩成功收件, 且不能 重复只为获取输出。 错误仍为错误。 这是回应 大小策略,不是符号限制,也不是在上游下载时绑定.
每个发送的呼叫都发出无载荷的JSON mcp_tool_response 以 stderr 为标准的事件
; 一些客户端显示这些日志。 主机可以提供 onResponseMetrics
把事件带到别的地方 使用 original.serializedChars 响应大小
百分位数和 exceededLimit 超限费率; returned 衡量结果
侍卫之后 计量还包括UTF-8字节计数、持续时间、工具/客户端以及
没有工具参数或反应机构.
下面的克洛德桌面步骤是实例,并非唯一的支持客户端. Cursor, VS 代码, Amazon Q, Claude 代码等都包含在其中 连接 向导.
远程( Streamable HTTP)
使用 Claude 桌面示例: 添加自定义连接符( C)+ + 添加连接器 + 添加自定义连接器)并设置远程 MCP 服务器 URL https://mcp.doit.com/mcp在提示时完成 DoiT 签名.
无头客户端( API 令牌)
无法打开浏览器的代理( 例如集群上的福尔摩斯GPT, CI 任务, cron 工人) 可以与客户验证到同一端点 个人 API 令牌 作为无记名信头发送。 工具运行 与该令牌的权限, 正是在stdio。 DoiT员工代币在远程端被不接受;员工使用OAuth或本地服务器.
福尔摩斯GPT示例:
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"
将信使放入秘密店并按期旋转. 设计注释 : 文件/远程钥匙携带者-自动。 。 。 .
当地( stdio)
支助 技能超过 MCP 用于兼容客户端。 没有技能被默认捆绑 .
要求node.js v20 或更高 个人 API 令牌为 DOIT_API_KEY。从 个人 API 令牌 doiT控制台中的页面.
使用 Claude 桌面的示例—— 将以下添加到 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。 。 。 .
每个连接的开口信息决定它使用的时代. 见 文件/议定书兼容性 细节和检验结果.
克隆到本地仓库
如果您想直接从源代码中复制和运行这个MCP服务器,请遵循这些步骤:
- 清除仓库
git clone https://github.com/doitintl/doit-mcp-server
cd doit-mcp-server
- 安装依赖关系
yarn install
- 构建工程
yarn build
- 运行服务器
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。 它没有初始化
或包括Cloudflare工人、OAuth、持久物体,或
部件执行.
重大成果
克劳德接受每个工具结果大约15万个字符,所以 executeToolHandler
以14万个字符为每个结果封顶。 超过上限的列表结果为
返回为部分而不是失败: 服务器保存合适的记录, 添加
pageSplit: { returnedRecords, remainingInResult }设置 pageToken 签 名
续作符. 将信使递回同一个工具返回下一个部分;
aPI 本身的光标仅在整个 API 页面发送后才会出现, 因此没有
记录被跳过或重复。 如果记录中停止的部分在
接下来的通话,继续按其指数恢复,所以重复记录而不是
跳过 Page 是选入: 一个只读列表工具,其端点为
没有呼喊自己的声明 resultPaged: true (工具对象上的手写工具,
生成的 src/tools/generated/overrides.ts)并获得可选 pageToken
参数。 单一资源工具没有可拆分的,阅读时不能重运行
(单位:千美元)ask_ava_sync别过来 分析结果rows)从不分裂,并保持大小
错误并带有缩小的提示。 记录收藏以外的字段( 计数、 兄弟姐妹)
诸如组件等地图 statussheet)描述整个结果,并在每个
页:1 登记生成的登记图的消费者在
已选择生成工具并应当通过 resultPaging 因此它产生效果.
Stdio服务器以随机的每个进程的秘密来签名符. 一个消费者
提供自己的运输通行证 resultPaging: { secret, cursorField } 改为
executeToolHandler,并应用 withResultPageToken 切换到每一个的 zod 策略
工具输入 RESULT_PAGED_TOOLS 当它从输出的策略中注册工具时
两家运输公司都宣传同样的论点.
用法实例
以下是一些常见的查询, 您可以使用 DoiT MCP 服务器询问 :
成本分析和节余
- "我的弹性储蓄是什么?" 这将分析你的弹性 成本优化节省 通过你的云账户.
- "按成本计算,我最好的3AWS服务是什么?" 这将运行一个 Cloud Analytics 查询, 以识别您花费最高的 AWS 服务 .
报告和分析
- "记录我所有的报告" 这将显示所有云分析报告 你访问.
- "给我看看我的"每月成本概览"报告的结果" 这将获取并显示具体报告的结果.
异常检测
- "我最近的GCP异常情况是什么?" 这将显示在您的 Google Cloud 平台账户中检测到的最新成本或使用异常 .
- "给我看关于异常点ABC123的细节"——这将提供具体异常点的详细信息.
发票
- "把我的发票都写下来" 这将显示您组织的当前和历史发票.
- "给我看看发票INV-2024-001的细节"——这将提供具体发票的全部细节,包括细列项目和付款状况.
这些例子显示了基本使用模式。 您可以根据您的需要合并和修改这些查询。 MCP 服务器将解析您的自然语言查询,并使用适当的工具获取请求的信息.
Claude 代码插件和频道( 研究预览)
此寄存器中的 Claude 代码插件将新的成本异常和云事件推入一个开放会话. 它只发送事件;工具来自多伊特云智能插件或远程连接器.
/plugin install doit --marketplace doitintl/doit-mcp-server
见 文档/频道 如何启动Claude Code的频道 一个组织需要允许什么.
环境变量
由当地stdio服务器使用. 远程 /mcp 连接认证到 OAuth .
DOIT_API_KEY: 您的 DoiT 密码 个人 API 令牌 (stdio需要时)CUSTOMER_CONTEXT: 您的客户上下文标识符( 可选)DOIT_CHANNEL_EVENTS: 打开 Claude 代码频道模式 (研究预览) 通过列出活动类型来推动一个开放会话:anomalies, (中文(简体) ),incidents(可选,默认关闭)DOIT_CHANNEL_POLL_SECONDS: 频道民调间隔以秒为单位, 最少为60( 可选, 默认为300)DOIT_CHANNEL_ONLY: 设定为true为有来自另一个连接的 DoiT 工具的会话服务频道事件和没有工具( 可选)