Fieldproxy

Fieldproxy MCP 服务

适用于 Fieldproxy 的官方 Model Context Protocol 服务。Fieldproxy 是一款 AI 原生现场服务管理软件。

它让团队已在使用的 AI 助手（Claude、ChatGPT、Microsoft 365 Copilot 和 Teams、GitHub Copilot、Cursor、OpenAI Codex、Claude Code，或任何 MCP 客户端）读取和更改 Fieldproxy 工作区，并基于工作区进行构建，同时由人员确认每项更改。

这是其他现场服务 MCP 服务都做不到的： 你的 AI 可以更改软件本身。提出新增字段、屏幕、表格、自动化或 Agent 的需求后，它会在工作区的沙盒副本中创建为草稿，只有管理员批准后才会正式启用，并支持回滚。

• 概览：https://www.fieldproxy.ai/mcp
• 哪些现场服务软件提供了 MCP 服务（经核实的对比）：https://www.fieldproxy.ai/mcp#which-fsm-has-mcp

此仓库包含文档和客户端配置。服务本身由 Fieldproxy 托管；无需安装或运行任何内容。

地址

请使用适用于你工作区所在区域的地址。

区域	地址
美国东部	https://api-us-east-1.fieldproxy.ai/mcp
加拿大	https://api-canada.fieldproxy.ai/mcp
印度	https://api-india-1.fieldproxy.ai/mcp
挪威	https://api-norway.fieldproxy.ai/mcp
新西兰	https://api-nz.fieldproxy.ai/mcp

传输方式：可流式传输的 HTTP。身份验证：OAuth 2.0 动态客户端注册（使用工作区 ID、电子邮件和密码登录），或使用 bearer 密钥（fpmcp.…）。

连接前须知

AI 助手访问默认关闭。Fieldproxy 会为每个工作区单独开启（Portal、Org features、AI assistant access、Enabled，以及可选的 Allow build）。请联系你的 Fieldproxy 联系人，或预约演示。

密钥（fpmcp.…）可在 Fieldproxy Web 应用中的 Settings, AI assistant, New key 下创建。每个密钥只会显示一次。管理员可以为其他人设置密钥；对方在自己的屏幕上认领一次即可，因此管理员永远看不到该密钥。

连接客户端

Claude（Desktop 和 claude.ai）

添加自定义连接器，并填入你所在区域的地址，然后使用工作区 ID、电子邮件和密码登录并勾选权限范围。登录有效期为 1 小时，并会自动续期 30 天。指南：https://www.fieldproxy.ai/mcp/claude

Claude Code

claude mcp add --transport http fieldproxy https://api-us-east-1.fieldproxy.ai/mcp \
  --header "Authorization: Bearer fpmcp.…"

ChatGPT（Web：Plus、Pro、Business、Enterprise、Edu）

1. 在 Settings, Security and login 中开启 Developer mode。
2. 创建一个名为 Fieldproxy 的开发者模式应用，填入你所在区域的地址，并选择 OAuth with dynamic client registration。
3. 在 Fieldproxy 页面登录并勾选要允许的权限。

ChatGPT 默认会在每次写入操作前询问；此外，Fieldproxy 自身的确认步骤仍然适用。指南：https://www.fieldproxy.ai/mcp/chatgpt

OpenAI Codex（CLI、IDE 扩展、桌面应用）

export FIELDPROXY_MCP_KEY="fpmcp.…"
codex mcp add fieldproxy --url https://api-us-east-1.fieldproxy.ai/mcp --bearer-token-env-var FIELDPROXY_MCP_KEY

或者在 ~/.codex/config.toml 中配置：请参阅 examples/codex-config.toml。如需登录而非使用密钥，请添加服务时不要使用 --bearer-token-env-var，然后运行 codex mcp login fieldproxy。

VS Code 中的 GitHub Copilot

将 examples/vscode-mcp.json 复制到 .vscode/mcp.json。VS Code 会提示输入一次密钥，并将其隐藏。如需通过 Fieldproxy 页面登录，请省略 headers。

Microsoft 365 Copilot 和 Teams（Copilot Studio）

1. 在 Copilot Studio Agent 中：工具，添加工具，新建工具，Model Context Protocol。
2. 将其命名为 Fieldproxy，添加一行描述，并输入所在区域的地址。
3. 身份验证：OAuth 2.0，动态发现（每个人使用自己的 Fieldproxy 账户登录），或 API 密钥，类型为 Header，名称为 Authorization，值为 Bearer fpmcp.…。
4. 创建连接，添加到 Agent，然后将 Agent 发布到 Teams 和 Microsoft 365 Copilot。

Copilot Studio 需要单独的 Microsoft 许可证，Power Platform 数据策略也可能会阻止连接。指南：https://www.fieldproxy.ai/mcp/copilot

Cursor 和其他 JSON 配置客户端

请参阅 examples/cursor-mcp.json。

功能

145 个内置工具，另有多达 14 个 Command Center 预制读取工具，以及工作区自行定义的任意工具（已保存的 SQL 工具）。

区域	功能
读取	架构和仅限 SELECT 的 SQL。客户、工单、技术人员、发票、报价、合同。应收账款账龄、技术人员绩效、销售漏斗。
写入	提议更改、确认更改、撤销更改。CSV 导入和导出、记录历史、还原记录、恢复已删除的记录。
调度和地图	为技术人员分配工单、规划每日路线、应用日程安排。地址、行车时间、最近的技术人员、实时位置和路线、工单签字确认链接。
通信	搜索收件箱并阅读会话。起草电子邮件和短信（含模板），然后确认发送。通知、评论、电子邮件跟进、列出并拨打电话。
销售文档	预览并签发方案、生成估算和 PDF 文档。
文件和照片	读取 PDF、Word、Excel、CSV 和电子邮件文件。查看工单照片，每次最多 10 张。
监控	仪表板、警报、定时报告、活动动态、洞察、用量。
自动化操作	运行规则、重试或关闭失败的运行、审批（仅限指定审批人）。
工作区设置	服务区域、已保存的视图、Command Center 记忆。
AI 监督（管理员）	工作区中的每个 AI 连接、各连接执行的操作、按密钥、人员和工具查看用量，以及撤销访问权限。
构建	应用：验证、起草、发布、回滚。表和列（永远不会删除任何内容）。自动化以及语音或文本 Agent：验证、保存、模拟、启用、恢复到某个版本。文档、电子邮件、方案和估算模板。
沙盒	复制工作区，在副本中构建，然后规划并确认将更改发布到正式环境。

七个预制工作流（提示词）：daily_ops_briefing、plan_the_schedule、triage_my_inbox、why_did_this_automation_fail、customer_360、build_an_app、build_a_dashboard。

权限范围

权限范围	要求	开放功能
data:read	已启用 Command Center，且用户有权访问 Command Center	架构、预制读取工具、只读 SQL
data:write	工作区允许 Command Center 写入的表，且未设置审批关卡	可撤销的写入、电子邮件和短信草稿
build	管理员身份，且工作区已启用 Allow build	应用、表、自动化、Agent、沙盒

用户自身的 Command Center 访问权限决定了上限。密钥还可以进一步限制权限：有效期（1 小时至 90 天）、表、行（例如“仅限团队 A 的工单”）、隐藏列、插入／更新／删除操作，以及 SQL、发送和构建区域的开关。Postgres 强制执行行限制，隐藏列会从每个结果中移除。

防护措施

• 更改前先确认。 每项写入、发送或操作都需要用户在 30 分钟内确认。写入操作可以撤销。超过 5 行需要批量操作权限；超过 1,000 行则会被拒绝。
• 构建结果保存为草稿。 如果代码检查器、针对数据库的 SQL 检查或导航检查发现新错误，则禁止保存或发布。新自动化和 Agent 保存时默认处于关闭状态。绝不会发布或更改公开应用。
• 限制发送。 电子邮件只能通过用户自己的邮箱发送，每个密钥每小时最多发送 20 封，并且必须在工作区的免打扰时段内。沙盒绝不会发送邮件。
• 无状态且可审计。 每次请求都会重新进行授权，因此被撤销的密钥会在下一次调用时遭到拒绝。每次调用都会记录所用工具、密钥、人员和结果。

示例请求

• “上周有哪些工作已完成，但没人开具发票？”
• “Mike 病了。把他的工作安排给距离最近的人，并给我看看计划。”
• “哪些报价超过 $5,000，且两周内没有跟进？起草相关邮件。”
• “为每项工作添加保修到期日期，并在保修到期前 30 天提醒服务经理。”
• “构建一个分包商合规界面，用于标记缺失的保险信息。”

链接

• 概览：https://www.fieldproxy.ai/mcp
• Claude：https://www.fieldproxy.ai/mcp/claude
• ChatGPT：https://www.fieldproxy.ai/mcp/chatgpt
• Microsoft 365 Copilot 和 Teams：https://www.fieldproxy.ai/mcp/copilot
• 预约演示：https://www.fieldproxy.ai/book-demo?source=github-mcp