Incidentflow MCP

发生率低mcp

IncidentFlow MCP服务器在MIT许可证下是开源的。

IncidentFlow云平台和托管服务是专有的。

本地API文档（OpenAPI+Fern）

该存储库包含代码衍生的OpenAPI规范和Fern-docs配置，因此贡献者可以在本地检查完整的公共API表面。

记录了什么

• 公共操作端点： /install.sh, /healthz, /readyz, /metrics
• MCP传输端点： /mcp (GET, POST, OPTIONS)
• 授权要求
• 请求/响应模式
• 可再用元件
• 常见错误响应(401, 403, 429, 500)
• MCP的JSON-RPC请求示例(initialize, tools/list, tools/call)

先决条件

安装Fern CLI：

npm install -g fern-api

生成并验证OpenAPI

make openapi-generate
make openapi-validate

输出规格：

• openapi/openapi.yaml

在本地运行Fern检查和文档

make fern-check
make fern-docs-dev

替代直接命令：

cd fern
FERN_NO_VERSION_REDIRECTION=true fern check
FERN_NO_VERSION_REDIRECTION=true fern docs dev
FERN_NO_VERSION_REDIRECTION=true fern generate --docs --preview

fern generate --docs --preview 可能需要 fern login （或 FERN_TOKEN)这取决于您的Fern帐户/工作区设置。

文档的自定义域

Fern文档配置了自定义域：

• docs.incidentflow.io

对于生产出版：

make fern-docs-publish

对于预览发布：

make fern-docs-generate

DNS注释：

• 创建 CNAME 记录 docs.incidentflow.io 在您的Fern仪表板/域设置中设置Fern提供的目标。

MCP模式保真度注意事项

这 /mcp 端点被实现为自定义ASGI代理路由，并支持OpenAPI无法完全编码的可流化HTTP行为（包括SSE路径）。\ OpenAPI文档有意捕获稳定的HTTP+JSON-RPC合约和代表性示例，而没有发明不存在的端点或传输行为。

CI自动化（GitHub操作）

此存储库包括一个文档工作流，位于 .github/workflows/docs.yml:

• 在pull请求上：生成OpenAPI，验证它，并运行 fern check.
• 关于推送 main：执行相同的验证，然后运行 fern generate --docs --preview 如果 FERN_TOKEN 已配置。
• 手动运行(workflow_dispatch)：set publish_production=true 发布到自定义域。

发布预览所需的存储库密码：

• FERN_TOKEN

VS代码MCP安装程序

在入口后部署此服务（例如， https://mcp.incidentflow.io), 该应用程序公开了一个动态安装程序端点：

curl -fsSL https://mcp.incidentflow.io/install.sh | bash

该脚本自动配置VS Code工作区 .vscode/mcp.json 与：

• type: "http"
• url: https:///mcp

首先检查安装程序（推荐）

您可以在运行安装程序之前检查它：

curl https://mcp.incidentflow.io/install.sh

或者：

curl https://mcp.incidentflow.io/install.sh | less

试运行

在不修改工作区的情况下预览更改：

curl https://mcp.incidentflow.io/install.sh | bash -s -- --dry-run

这将打印将要写入的MCP配置。

速率限制和工具防护装置

此服务器在两层中应用面向生产的保护：

1. HTTP传输级别限制（返回 429 Too Many Requests)
2. 主控程序 tools/call 执行保护（结构化JSON-RPC/MCP错误）

运输水平限制

受保护的端点：

• /mcp
• 身份验证端点（如果存在）(/authorize, /token, /register, /oauth/register)

身份解析顺序：

1. workspace_id + user_id
2. client_id
3. 客户端IP

计划元数据作为原始身份元数据传递（例如 auth_context["plan"] 或 X-Plan/X-Plan-Tier 标题）。核心OSS逻辑不映射或硬编码SaaS层。

默认OSS策略：

• 未经身份验证： 20 req/min 按IP
• 已验证： 60 req/min 按本金计算

在达到传输限制时，服务器返回HTTP 429 与：

• Retry-After
• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

工具级别限制和执行策略

对于 tools/call 请求：

• 经过身份验证的默认值： 20 calls/min
• 昂贵的工具： 5 calls/min 每个身份
• 经过身份验证的默认并发性：最大 2 并发工具执行
• 默认超时： 30s （可选择每个工具的超控）

Bucket密钥选择是由策略驱动的(ip | principal | workspace)并与身份分开解决。

工具保护错误作为结构化MCP/JSON-RPC错误返回，并带有安全消息，例如：

• Rate limit exceeded for tool invocation
• Too many concurrent tool invocations
• Tool execution timed out

昂贵工具政策

通过以下方式设置昂贵的工具：

EXPENSIVE_TOOLS=incident_graph_build,large_correlation,slack_thread_mining,github_org_search

Redis要求

速率限制和并发状态是Redis支持的跨多个应用副本工作。 在地方发展方面：

REDIS_URL=redis://:redis-dev-password@127.0.0.1:6379/0

指标

暴露在 /metrics （普罗米修斯格式）：

• mcp_http_requests_total
• mcp_http_rate_limited_total
• mcp_tool_calls_total
• mcp_tool_rate_limited_total
• mcp_tool_timeouts_total
• mcp_tool_concurrency_rejections_total

有关生产MCP可观察性设计、PromQL和警报示例，请参阅 docs/observability.md.

托管令牌自检模式（推荐）

对于SaaS部署，首选来自以下位置的托管凭据 platform-api 超过静态 INCIDENTFLOW_PAT.

在中设置这些变量 incidentflow-mcp:

PLATFORM_API_BASE_URL=http://127.0.0.1:8000
PLATFORM_API_INTROSPECT_PATH=/api/v1/tokens/introspect
PLATFORM_API_TIMEOUT_SECONDS=5

在此模式下，MCP通过平台api验证传入的承载令牌，并接收 从自省响应中提取工作区/用户/范围上下文。令牌元数据，如 作为 last_used_at 在自省期间在平台api中更新。

回退行为：

• 如果 PLATFORM_API_BASE_URL 未设置，MCP使用本地身份验证(INCIDENTFLOW_PAT 和/或本地回购令牌）。
• 在生产环境中，必须至少配置一个身份验证源(PLATFORM_API_BASE_URL 或 INCIDENTFLOW_PAT).

external_status_check 响应模式

external_status_check 支持两种输出模式：

• response_mode=compact （默认）：VS代码/复制副本渲染的聊天安全摘要。
• response_mode=full：用于深入RCA分析的原始平台作业有效载荷。

轮询行为：

• 如果 check_id 提供，MCP轮询现有 job_id 并且不创建新作业。
• 如果 check_id 如果省略，MCP将提交一个新的异步作业。

示例（紧凑型）：

{
  "providers": ["github"],
  "wait_for_result": true,
  "days_back": 30,
  "response_mode": "compact"
}

示例（完整）：

{
  "providers": ["github"],
  "wait_for_result": true,
  "days_back": 30,
  "response_mode": "full"
}