Locus Pro MCP Server

什么是 Locus Pro MCP Server？

Locus Pro MCP 服务器通过一个连接和一份预付积分余额，让你的代理访问数千个付费 API，包括搜索、研究、数据补全和各类数据提供商。它托管在 https://api.paywithlocus.com/api/credits/mcp，使用浏览器 OAuth。

Locus Pro 的设计目的是让你不必为每个提供商单独开户和绑卡。你批准代理可使用的工具并为余额充值；代理会找到合适的端点、查看价格、调用它并报告花费。Locus 的示例使用了 BuiltWith、Apollo、Hunter、ZeroBounce、Firecrawl 和 RentCast 等提供商。Locus Pro 与该公司的 USDC 钱包产品 Pay With Locus 是分开的，不需要加密钱包。

如何使用 Locus Pro MCP Server？

将服务器添加到客户端并完成浏览器登录；代理首次连接时即可创建 Locus 账户。新账户的余额为零，因此需要在 Credits 中通过银行卡（Stripe Checkout）充值。按默认费率，1 个积分等于 $0.001。

服务器 URL：

https://api.paywithlocus.com/api/credits/mcp

Claude Code

claude mcp add --transport http locus-pro https://api.paywithlocus.com/api/credits/mcp

然后在 /mcp 中完成认证。Locus 还提供一个插件，包含此连接以及用于设置、工具使用和 Workflows 的技能。

Claude Desktop

添加一个名为 Locus 的自定义连接器并填入 MCP URL（Settings → Connectors → Add custom connector），然后登录。对于 claude.ai 和 Claude Cowork，Locus 还建议上传它的三个技能压缩包（locus、locus-setup、locus-workflows）。

Cursor

{
  "mcpServers": {
    "locus-pro": {
      "url": "https://api.paywithlocus.com/api/credits/mcp"
    }
  }
}

将其添加到 ~/.cursor/mcp.json，并在浏览器中完成 OAuth。

VS Code

{
  "servers": {
    "locus-pro": {
      "type": "http",
      "url": "https://api.paywithlocus.com/api/credits/mcp"
    }
  }
}

将其添加到 .vscode/mcp.json，启动服务器后登录。

Locus 还提供了 Codex（codex mcp add locus-pro --url <URL>，然后 codex mcp login locus-pro）、ChatGPT 和 Cline 的说明。无界面的客户端可以使用 OAuth 设备授权流程。企业配置可以使用有权限范围的 Agent Connection 凭据，以 Authorization: Bearer ${LOCUS_AGENT_CONNECTION} 形式发送。

Locus Pro MCP Server 的主要功能

• 一份余额覆盖数千个按次付费端点，在运行时发现，而不是作为独立工具全部加载。
• 发现与执行工具：search_apis、describe_api、estimate_cost、execute、get_call_result 和 get_balance。
• request_tool_access 可为尚未启用的工具生成人工审批链接。
• web_research、web_extract、gtm_enrich、router_web_search 和 travel_flights 等 Recipes，用于常见的多提供商任务。
• Workflows（workflow_definition、workflow_validate、workflow_run、workflow_runs）可保存流程并在硬性积分上限内重复运行。
• 标准模式或精简模式（?surface=compact）控制加载到上下文中的工具定义数量，?tool=provider/endpoint 可将最多 20 个端点固定为直接工具。
• 支出控制：每月支出上限、余额不足提醒、自动充值，以及企业连接上的单次调用和单次运行限额。

Locus Pro MCP Server 的使用场景

• 潜在客户研究：“找出 20 个使用 Shopify Plus 和 Klaviyo 的美国品牌，补充电商负责人和已验证的工作邮箱，开始前先给我一个估价。”
• 竞争分析：“用 Locus 研究三个竞争对手，阅读他们当前的定价页面，并附上来源比较功能。”
• 房产对比：“用房产记录、租金估算和通勤距离比较这五个租房房源。”
• 记录补全：“使用 gtm_enrich 为这家公司补全信息，并附上字段级来源。”
• 可重复任务：“将这个研究流程保存为 Workflow，并在 5,000 积分上限内对下周的名单运行。”

Locus Pro MCP Server 常见问题排查

• 付费调用被拒绝。 只读授权（mcp:read）允许发现、查询余额和估价；付费调用和 Workflows 需要 mcp:execute。请重新连接并授予执行权限。
• 某个工具不可用。 搜索默认只返回已启用的工具。让代理调用 request_tool_access，然后批准链接。
• 上下文中的工具定义过多。 使用 ?surface=compact 切换到精简模式，然后刷新连接或开启新会话。
• 达到支出上限后调用停止。 每月支出上限达到后会阻止新的调用；请提高上限或在 Credits 中充值。
• 第二个代理应用无法连接。 默认包含一个活动的 OAuth 客户端；Plus（每月 $20，3 个客户端）或 Unlimited（每月 $200）方案可增加更多。