如何将 CircleCI 远程 MCP 连接到 Claude

约 1 分钟即可把 CircleCI 的远程 MCP 服务端接入 Claude。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedStreamable HTTPOAuth 2.1🛡️ A+~359 tok5 tools
Streamable HTTPhttps://mcp.circleci.com/v1/mcp
  1. Open Settings → Connectors (Integrations) → Add Custom Connector.
  2. Paste the endpoint URL: https://mcp.circleci.com/v1/mcp
  3. Complete the browser OAuth 2.1 login flow when prompted.

接入步骤

  1. 打开连接器设置 — 在 claude.ai → Settings → Connectors 中选择「添加自定义连接器」。
  2. 填入远程端点 — 将 https://mcp.circleci.com/v1/mcp 粘贴为 Remote MCP Server URL 并保存。
  3. 完成认证 — 首次调用时客户端会打开 CircleCI 的 OAuth 授权页面——点击允许后工具即可用。
  4. 验证 — 在 在线 Inspector 中粘贴 https://mcp.circleci.com/v1/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(5)

ToolSafetyDescriptionParameters
list_pipelines
~69 tok
🟢 ReadList recent pipelines for a project.projectSlug*: stringbranch: string
get_workflow_status
~54 tok
🟢 ReadGet jobs and status of a workflow.workflowId*: string
get_job_logs
~70 tok
🟢 ReadFetch step output logs for a job.jobNumber*: stringprojectSlug*: string
rerun_workflow
~71 tok
🟠 WriteRe-run a workflow or failed jobs only.workflowId*: stringfromFailed: boolean
analyze_job_failure
~75 tok
🟢 ReadSummarize the failure reason for a failed job.jobNumber*: stringprojectSlug*: string

更多连接指南