Locus

Locus プラグイン

コーディングエージェント向けの従量課金制 API です。このプラグインは Locus MCP サーバーに接続し、エージェントがその機能をうまく使えるようにします。引用付きのウェブ調査、有料データや API の検索、そしてプリペイドのワークスペースクレジット残高から料金が引き落とされる、従量課金制プロバイダーの数千ものエンドポイントを利用できます。

1 つのリポジトリで、複数のエージェントを利用できます。Claude Code、Codex、Grok は現在、プラグインを直接インストールできます。その他のクライアントでは、同じリポジトリの MCP 設定、3 つの Agent Skills、または以下の 1 つの URL を使ったブートストラップを利用できます。

利用できる機能

• MCP サーバーへの接続：https://api.paywithlocus.com/api/credits/mcp （ストリーミング可能な HTTP）。サインインにはブラウザーでの OAuth 同意を使用します。設定にキーは保存されません。
• locus スキル：ツールの振り分け、料金の見積もり、冪等な課金、エラーからの復旧、支出の安全管理をエージェントに指示します。
• locus-setup スキル：ユーザーから依頼された場合に、エージェントがセットアップを行うためのオンボーディングです。OAuth ページを使った人間によるサインアップが標準です。ヘッドレスランタイム向けに AgentID を使ったエージェント所有アカウントも用意されており、そのアカウントでのみ、エージェントによる機能選択と、ユーザーから依頼された 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 として手動で追加済みですか？同じサーバーへの接続が 2 つにならないよう、先に削除してください（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 セッションを開始します。プラグインによって、3 つすべてのスキルと 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 で、以下の 3 つすべてをアップロードします。

• 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.

ブートストラップによって、サポート対象のアダプターと公開済みの 3 つすべてのスキルツリーがインストールされ、その後、ブラウザーまたはデバイスでの認証手順が案内されます。Hermes の公式プラグイン一覧への掲載はまだ保留中です。hermes plugins install locus はまだ利用できません。

Cline

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

Remote (HTTP) を選択したまま、OAuth を選び、動的登録を使うためにクライアント ID は空欄にして、ブラウザーでサインインを完了します。クローン、ビルド、API キー、環境変数は不要です。次に、3 つすべてのスキルをインストールします。

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

locus、locus-setup、locus-workflows を選択し、新しいセッションを開始します。

Cursor

MCP サーバーを ~/.cursor/mcp.json に直接追加します：

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

Cursor の OAuth フローは、初回使用時にブラウザーで完了します。Locus の掲載が Cursor Marketplace の審査を通過すると、Customize → Plugins（「Locus」を検索）からインストールするか、チャットで /add-plugin locus を実行してインストールできるようになります。それまでは、npx skills add locus-technologies/locus-pro-plugin を使って3つのスキルを個別にインストールし、3つすべてを選択してください。

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.

ブートストラップにより、サポートされているアダプターと、リリース済みの3つのスキルツリーすべてがインストールされます。現在の OpenClaw はマーケットプレイスバンドルを展開できますが、MCP サーバーはインポートしません。そのため、ホスト側の動作が変わるまではマーケットプレイス経由でインストールしないでください。

Muse と Instinct

いずれかのエージェントに、テスト済みの同じプロンプトを送信してください：

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

スキルのみ（77以上のエージェント）

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

Locus の使用方法、セットアップ、Workflow のスキルを検出し、選択したスキルを利用中のエージェントにインストールします。スキルには接続手順が含まれています。ツールを利用できるようにするには、クライアントの設定に 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 を呼び出してください。

1つの URL によるブートストラップとリモートガイド

対応可能なエージェントに https://paywithlocus.com/SKILL.md を読み取らせ、Locus をセットアップするよう依頼してください。ブートストラップは実際のホストを調査し、正常な既存接続を維持し、サポート対象のアダプターを選択したうえで、未対応のブラウザーでの同意、再起動、またはランタイムの制限を報告します。

MCP のみを扱うホストでは、永続ファイルは不要です。接続後に get_locus_guide を呼び出すことで、このリポジトリで公開されているものと同じバージョン管理されたスキルとリファレンスのコンテンツを取得できます。公開ガイドマニフェストは Locus API から提供されます。顧客が所有する Workflow のソースと呼び出しガイドは非公開のアカウント成果物として保持され、公開バンドルに含まれることはありません。

ホストされた Workflow ツールは、バックエンド機能が利用可能で、現在の接続で実行できる場合にのみ公開されます。Workflow の実行は、既存の接続の範囲内に制約された子プロセスであり、2つ目の登録済みエージェントではありません。最初のランタイムは、承認済みの TypeScript と、Locus がレビューした、ライブ状態にあるカタログ内のすべてのバインディングに対応しています。これには、ネイティブの Tools、保守されている Recipes、明示的に検証済みの外部 buyer-rail 掲載が含まれます。テナントがインポートしたバインディングと、検証されていない外部バインディングには、例外的なプラットフォーム承認が必要です。サーバーの拒否オーバーライドによって、どのバインディングも停止できます。接続スコープ、有効化、コントラクト、可用性、実行予算は引き続き適用されます。ランタイムには、制限付きの同時実行、フィクスチャ、パイロット、永続的な検査、キャンセル、再開の機能もあります。任意の npm 依存関係、外部コネクターの認証情報、スケジューリング、公開は含まれません。

データの取り扱い

プラグインが管理する MCP 設定では、静的なリクエストヘッダー X-Source-Name（例：cursor-plugin）を 1 つ送信します。これはホストが選択した設定形式を識別するもので、匿名の利用状況テレメトリーにのみ使用される場合があります。複数の形式に対応するホストでは、独自のオーバーレイよりも、同梱された別の定義を優先することがあります。たとえば、OpenClaw のバンドルローダーはルートの .mcp.json を優先するため、grok-plugin を報告します。このヘッダーは表示上のものです。静的ヘッダーを設定できない通常の MCP クライアントでも、ヘッダーなしで動作します。

このリポジトリには認証情報の値が含まれておらず、MCP 設定にも保存されません。ツール呼び出しでは、エージェントが指定した引数を https://api.paywithlocus.com に送信し、認証済みのワークスペースに課金されます。ユーザーが任意のエージェント所有セットアップパスを明示的に選択した場合、セットアップスキルはさらに、受信トレイの作成と検証、および公開署名鍵の登録のために https://api.agentmail.to、署名付き承認の送信のために https://api.auth.agentid.com、その認証トランザクションを続行するために https://auth.agentid.com を呼び出します。AgentMail に送信されるのは、ユーザーが承認したメールアドレスと受信トレイ名、ユーザーが提供したワンタイムコード、および公開鍵のみです。AgentID に送信されるのは、受信トレイの ID とワンタイムの署名付きアサーションです。秘密署名鍵はローカルで生成され、送信されることはありません。資金調達の呼び出しでは https://api.paywithlocus.com が使用され、サーバーから提供された Stripe Checkout の URL が返されます。ユーザーはこの URL をブラウザーで開きます。プラグインもエージェントもカード情報を扱いません。

認証と認証情報

人間が所有する MCP 接続では、動的クライアント登録を使用する OAuth 2.1 を使います。クライアントは URL から登録方式を検出し、ブラウザーでサインイン画面を開きます。Locus ダッシュボードの同意画面で接続のスコープを設定します。アクセストークンとリフレッシュトークンはクライアント固有の OAuth ストアに保持され、このリポジトリのファイルに保存されることはありません。

任意のエージェント所有セットアップパスでは、AGENTMAIL_API_KEY、ローカルで生成された P-256 署名鍵、および LOCUS_AGENT_CREDENTIAL として保存される lcac_ 値が作成される場合があります。これらはランタイムで承認されたシークレットストアにのみ保存してください。MCP 設定、チャット、プロジェクトファイル、ソース管理、ログ、コマンド引数には決して含めないでください。LOCUS_SECRET_KEY は保護対象の認証情報の種類としてのみ言及されており、スキルが読み取ったり設定したりすることはありません。また、lcr_ や lcac_ の値を MCP 設定に含めてはいけません。

コストと安全性

有料プロバイダーの呼び出しは実際に実行され、ワークスペースのクレジット残高に課金されます。カタログの検索、見積もり、残高確認は無料です。スキルは、再試行時に同じキーを再利用すれば二重課金されないよう、エージェントに冪等性キーを渡すよう指示します。また、重要な呼び出しの前に 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）には、リリース後に各審査ポータルから申請します。

ブランチポリシー、必須チェック、リリースの前提条件、本番環境および stage MCP 環境での Claude Code、Codex、Cursor、Grok、OpenClaw、Agent Plugins、Agent Skills、ChatGPT を対象とした分離ローカルテストの手順については、AGENTS.md を参照してください。

リンク

• ドキュメント：https://docs.paywithlocus.com
• ダッシュボード：https://platform.paywithlocus.com
• MCP リファレンス：https://paywithlocus.com/agent/mcp.md

ライセンス

MIT