Field Control MCP 服务器

远程 MCP（模型上下文协议）服务器，将 Claude 连接到 Field Control 集成 API（https://developers.fieldcontrol.com.br/）， 允许在与 Claude 的对话中直接查询和创建客户、服务订单、员工、 服务请求、设备等。

它提供什么

可供 Claude 使用的工具（tools）：

Related MCP server: Jobber MCP Connector

1. 获取您的 Field Control API 密钥

1. 以管理员身份访问 Field Control 面板。

2. 前往 设置 > 开发者配置 （或直接访问：https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores）。

3. 在“集成密钥”中，点击创建新密钥，命名并点击 创建。

4. 保存该密钥 — 您将把它用作环境变量 FIELD_CONTROL_API_KEY。

2. 本地运行（可选，用于测试）

npm install
FIELD_CONTROL_API_KEY="sua-chave-aqui" npm start

服务器在 http://localhost:3000 启动，MCP 端点为 POST /mcp。

3. 将服务器部署到互联网（Claude 访问所必需）

Claude 从 Anthropic 云端连接，因此服务器需要 通过 HTTPS 公开可访问。任何能运行 Node.js 的提供商 都可以。两个简单且有免费层的选项：

选项 A：Render.com

1. 将此项目上传到 GitHub 仓库。

2. 在 Render 中，创建一个指向该仓库的 Web Service。

3. 构建命令：npm install — 启动命令：npm start。

4. 在“环境”中，添加变量 FIELD_CONTROL_API_KEY 并填入您的密钥。

5. 部署后，您将获得一个类似 https://seu-app.onrender.com 的 URL。 MCP 端点将是 https://seu-app.onrender.com/mcp。

选项 B：Railway.app

1. 将项目上传到 GitHub。

2. 在 Railway 中，“新建项目” > “从 GitHub 仓库部署”。

3. 添加环境变量 FIELD_CONTROL_API_KEY。

4. Railway 会自动检测 npm start 并暴露一个公共 URL。

（任何其他 Node.js 主机 — Fly.io、带 functions 的 Vercel、自己的 VPS 配合 Nginx 等 — 都可以同样工作，只要通过 HTTPS 暴露 /mcp。）

4. 作为自定义连接器连接到 Claude

1. 在 Claude 中，前往 设置 > 连接器。

2. 点击 +，然后点击 添加自定义连接器。

3. 粘贴您的服务器 URL，以 /mcp 结尾 （例如：https://seu-app.onrender.com/mcp）。

4. 命名（例如：“Field Control”）并点击 添加。

完成 — 在接下来的对话中，只要有助于回答您的请求，Claude 就可以列出您的服务 订单、客户、员工等。

在 Team/Enterprise 计划中，所有者需要先在组织设置 > 连接器 > 添加 > 自定义 > Web 中启用连接器；然后每个成员连接自己的账户。

安全性

• API 密钥仅存储在服务器上（环境变量），绝不会 暴露给 Claude 或浏览器。

• 默认情况下，所有使用此服务器的人共享同一个 API 密钥（环境中的那个）。如果您想将此连接器提供给多个 使用不同密钥的人，请修改 src/server.js 中的 getApiKeyFromRequest()， 使其从每个请求的 header 中读取密钥，并让每个人 在连接器的“高级设置”中进行配置。

• 切勿将您的 API 密钥提交到仓库 — 始终使用 托管提供商的环境变量。