Locus

Locus 插件

面向编码 Agent 的按次付费 API。此插件连接 Locus MCP 服务，并教会你的 Agent 如何充分使用它：带引用的网络调研、付费数据和 API 查询，以及数千个按量计费的提供商端点，费用统一从预付工作区余额中扣除。

一个代码库，支持多个 Agent。Claude Code、Codex 和 Grok 现在都可以直接安装此插件。其他客户端可以使用同一代码库中的 MCP 配置、三个 Agent Skills，或下方的一键 URL 初始化方式。

你将获得

• MCP 服务连接，地址为 https://api.paywithlocus.com/api/credits/mcp （可流式传输的 HTTP）。通过 OAuth 浏览器授权登录；配置中不会存储密钥。
• locus 技能：为 Agent 提供操作说明，涵盖工具路由、费用报价、幂等计费、错误恢复和支出安全。
• locus-setup 技能：当用户要求 Agent 执行设置时提供引导。默认方式是用户通过 OAuth 页面自行注册。无头运行环境可通过 AgentID 创建由 Agent 管理的账户；只有这类账户支持由 Agent 选择功能，以及在用户请求后交接至 Stripe 充值；由用户管理的账户则通过仪表板管理这两项。
• locus-workflows 技能：通过同一授权连接，安全地编写托管 Workflow、使用测试固件、开展有界试点、管理不可变版本，以及持久化恢复运行。

还没有账户？在打开的 OAuth 登录页面上授权服务器并创建账户；对于有浏览器的用户，这就是全部流程。在 platform.paywithlocus.com 的仪表板中启用工具并添加额度。

安装

Claude Code CLI

/plugin marketplace add locus-technologies/locus-pro-plugin
/plugin install locus@locus

然后运行 /mcp，选择 locus 并完成身份验证。

已通过 claude mcp add 手动添加了名为 locus-pro 的服务？请先移除它（claude mcp remove locus-pro），避免连接到同一服务两次。

Claude Code 应用

在 Code 中，打开 Customize → Plugins → Add plugin → Add marketplace → Add from a repository。选择 locus-technologies/locus-pro-plugin，点击 Sync， 然后点击 Add Locus。在 Terminal 中验证插件：

claude mcp login plugin:locus:locus

完成浏览器授权后，启动新的 Code 会话。插件会同时加载全部三项技能和 Locus MCP 连接。

Claude Cowork 和 claude.ai

打开 Customize → Connectors → Yours → Add connector → Add custom connector。 将其命名为 Locus，使用 https://api.paywithlocus.com/api/credits/mcp，然后通过浏览器 OAuth 连接。 在 Customize → Skills → Yours → Add skill 下，上传全部三项：

• locus.zip
• locus-setup.zip
• locus-workflows.zip

ChatGPT.com

在 Settings → Apps → Advanced settings 中启用 Developer mode，然后打开 Plugins → Create app。使用上方的生产环境 MCP URL 和 OAuth。如果当前的自定义技能选择器拒绝生产环境压缩包，请保留 MCP 应用，并使用 get_locus_guide 获取相同版本的操作指南。

Codex

codex plugin marketplace add locus-technologies/locus-pro-plugin
codex plugin add locus@locus
codex mcp login locus

Hermes

将此提示词发送给 Hermes：

Install Locus Pro by following https://paywithlocus.com/SKILL.md. Use production.

初始化程序会安装受支持的适配器和所有三个已发布的技能目录，然后引导你通过浏览器或设备完成身份验证。官方 Hermes 插件列表仍在等待发布；hermes plugins install locus 目前尚不可用。

Cline

cline mcp install locus --transport http \
  https://api.paywithlocus.com/api/credits/mcp

保留 Remote (HTTP)，选择 OAuth，将客户端 ID 留空以启用动态注册，然后在浏览器中完成登录。无需克隆、构建、API 密钥或环境变量。然后安装全部三项技能：

npx skills add locus-technologies/locus-pro-plugin

选择 locus、locus-setup 和 locus-workflows，然后启动新会话。

Cursor

直接在 ~/.cursor/mcp.json 中添加 MCP 服务：

{
  "mcpServers": {
    "locus": {
      "url": "https://api.paywithlocus.com/api/credits/mcp",
      "headers": { "X-Source-Name": "cursor-plugin" }
    }
  }
}

Cursor 的 OAuth 流程会在首次使用时于浏览器中完成。Locus 列表通过 Cursor Marketplace 审核后，你还可以通过 自定义 → 插件（搜索“Locus”）或在聊天中使用 /add-plugin locus 安装。在此之前，请分别安装三个技能，并选择全部三个：npx skills add locus-technologies/locus-pro-plugin。

Grok

grok plugin install locus-technologies/locus-pro-plugin --trust

Grok 要求明确授予信任才能安装插件（插件可能运行 MCP 服务和技能）；请先检查代码库，然后传入 --trust。Grok 会自动发现服务的 OAuth，并在首次使用时打开浏览器流程。

OpenClaw

向 OpenClaw 发送此提示词：

Install Locus Pro by following https://paywithlocus.com/SKILL.md. Use production.

引导程序会安装受支持的适配器和所有三个已发布的技能树。当前版本的 OpenClaw 可以解包 Marketplace 套件，但不会导入其中的 MCP 服务，因此在该宿主行为发生变化之前，请勿使用 Marketplace 方式。

Muse 和 Instinct

向任一 Agent 发送同一条经过测试的提示词：

Install Locus Pro by following https://paywithlocus.com/SKILL.md. Use production.

仅安装技能（77+ 个 Agent）

npx skills add locus-technologies/locus-pro-plugin

此操作会发现 Locus 使用、设置和 Workflow 技能，并将你选择的技能安装到你使用的任意 Agent 中。技能包含连接说明；请在客户端设置中添加 MCP 服务，以便使用这些工具。

任意 Agent Plugins 客户端

npx plugins add locus-technologies/locus-pro-plugin

纯 MCP（无插件）

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

对于支持文件的客户端，请同时使用上方的仅安装技能方式。在仅支持 MCP 的宿主上，连接后调用 get_locus_guide。

单 URL 引导和远程指南

请有能力的 Agent 读取 https://paywithlocus.com/SKILL.md 并设置 Locus。引导程序会探测实际宿主，保留正常运行的现有连接，选择受支持的适配器，并报告仍待处理的浏览器授权、重启或运行时限制。

仅支持 MCP 的宿主无需持久化文件。连接后，它可以调用 get_locus_guide，获取本仓库发布的相同版本化技能和参考内容。公开指南清单由 Locus API 提供；客户拥有的 Workflow 源代码和调用指南仍是私有账户资料，不会进入公开套件。

只有在后端功能已启用且当前连接能够执行时，才会公布托管的 Workflow 工具。Workflow 运行是现有连接的受限子任务，而非另一个已注册的 Agent。首个运行时支持经过批准的 TypeScript，以及 Locus 审核过的所有在线目录绑定，包括原生 Tools、维护中的 Recipes 和经过明确验证的外部买方渠道列表。租户导入和未经验证的外部绑定需要特殊的平台审批；服务端拒绝覆盖可以停止任何绑定。连接范围、启用状态、合约、可用性和运行预算仍然适用。该运行时还提供并发限制、测试装置、试点、持久检查、取消和恢复；这并不意味着支持任意 npm 依赖项、外部连接器凭据、调度或发布。

数据处理

插件管理的 MCP 配置会发送一个静态请求标头 X-Source-Name（例如 cursor-plugin）。它用于标识主机所选的配置格式，且只能用于匿名采用情况遥测；支持多种格式的主机可能会优先选择不同于自身覆盖配置的捆绑定义。例如，OpenClaw 的捆绑加载器会遵循根目录中的 .mcp.json，因此会报告 grok-plugin。该标头仅用于说明：无法配置静态标头的普通 MCP 客户端仍可正常使用。

此代码仓库不包含凭据值，其 MCP 配置也不会存储凭据。工具调用会将 Agent 提供的参数发送到 https://api.paywithlocus.com，费用计入已验证身份的工作区。如果用户明确选择可选的由 Agent 所有者管理的设置路径，设置技能还会调用 https://api.agentmail.to 创建并验证收件箱、注册公钥，调用 https://api.auth.agentid.com 提交签名审批，并调用 https://auth.agentid.com 继续该授权事务。AgentMail 只会收到用户批准的电子邮件地址和收件箱名称、用户提供的一次性代码以及公钥；AgentID 会收到收件箱身份和一次性签名断言。私钥在本地生成，绝不会发送。充值调用 https://api.paywithlocus.com，并返回服务器提供的 Stripe Checkout URL，供用户在浏览器中打开；插件和 Agent 均不会处理银行卡信息。

身份验证和凭据

由人类所有者管理的 MCP 连接使用 OAuth 2.1 和动态客户端注册：客户端会从 URL 发现注册信息，打开浏览器进行登录，并通过 Locus 控制面板中的同意屏幕限定连接权限。访问令牌和刷新令牌保存在客户端原生 OAuth 存储中，不会存入此代码仓库的文件。

可选的由 Agent 所有者管理的设置路径可能会创建 AGENTMAIL_API_KEY、本地生成的 P-256 签名密钥，以及以 LOCUS_AGENT_CREDENTIAL 存储的 lcac_ 值。只能将这些凭据保存在运行时批准的密钥存储中；切勿将其放入 MCP 配置、聊天、项目文件、源代码管理、日志或命令参数中。这里只将 LOCUS_SECRET_KEY 作为需要保护的凭据类别提及；技能不会读取或设置它，lcr_ 和 lcac_ 值也都不应放入 MCP 配置中。

费用和安全

付费提供商调用会实时执行，费用计入工作区信用余额；目录发现、报价和余额检查均免费。技能会指示 Agent 传递幂等键，以确保重试时复用同一密钥不会重复扣费；在执行重要调用前先使用 estimate_cost 获取报价，并在支出异常高时先征求你的确认。可在控制面板中按工作区配置支出限额和审批。

代码仓库布局

路径	使用方
.claude-plugin/	Claude Code（插件 + 市场清单）
.codex-plugin/、agents/codex/.mcp.json、.agents/plugins/	原生 Codex 插件、MCP 配置和市场清单
.cursor-plugin/	Cursor
.mcp.json、skills/	根目录 plugin.json 存在时生效的 Grok 组件（Grok 优先采用根目录清单）
.grok-plugin/、agents/grok/	Grok 市场提取内容，以及根目录清单不存在时使用的回退配置
plugin.json、mcp.json	Agent Plugins（开放标准）
agents/<client>/	按客户端划分的 MCP 服务配置；Hermes 技能视图由 skills/ 生成
skills/	规范的 Agent Skills 格式说明；metadata.openclaw 是用于声明凭据的有意设计的主机扩展

开发与发布

更改会合并到 stage。在晋级发布前，维护者会为每个宿主清单明确选择一个语义化版本，并编写对应的变更日志条目；CI 会检查版本是否一致，但绝不会更新版本。通过验证的 stage 到 main 晋级会创建不可变的 GitHub 发布、带校验和的插件与技能归档、Agent Skills 发现负载，以及匹配的 MCP Registry 版本。需要供应商审核的公共目录（OpenAI 和 Cursor）会在发布后通过其审核门户提交。

请参阅 AGENTS.md，了解分支策略、必需检查、发布前提条件，以及如何在 Claude Code、Codex、Cursor、Grok、OpenClaw、 Agent Plugins、Agent Skills 和 ChatGPT 中隔离测试生产环境与 stage MCP 环境。

链接

• 文档：https://docs.paywithlocus.com
• 控制面板：https://platform.paywithlocus.com
• MCP 参考：https://paywithlocus.com/agent/mcp.md

许可证

MIT