Synap

Synap MCP サーバー

Linkrra の Synapを Model Context Protocol サーバーとして提供します。1 つの OpenAI 互換 API の背後にオープンモデルがあります。エージェントは、提供モデルの一覧や価格、制限を確認し、ジョブを実行する前にコストを見積もり、チャット補完を実行できます。

サーバーは 1 つで、https://pool.linkrra.com/mcp（Streamable HTTP）でホストされています。公式 MCP レジストリの com.linkrra/synap の背後にあるサーバーです。

このリポジトリは 2 つの部分で構成されています。

• routes.js は、デプロイ済みルーターそのものです。バイト単位で同一です。
• bin/synap-mcp.js は、ローカルコマンドを起動する MCP ホスト向けの stdio トランスポート（npx synap-mcp）です。すべてのメッセージを変更せずにホストサーバーへ送信するため、ホストサーバーと常に同じツールを公開します。

ツール

ツール	コスト	キーが必要
synap_list_models	無料	いいえ
synap_get_model	無料	いいえ
synap_estimate_cost	無料	いいえ
synap_chat_completion	プロンプトおよび補完トークンごとに課金	はい

モデル ID は synap_list_models が返すものを使用します。synap-v1 を渡すと、Synap がジョブを実行できる最も安価なモデルを選びます。

接続

ホスト型（Streamable HTTP）、インストール不要

{
  "mcpServers": {
    "synap": {
      "type": "http",
      "url": "https://pool.linkrra.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_SYNAP_API_KEY" }
    }
  }
}

ローカル stdio（Claude Desktop、Cursor、Cline、Windsurf、Zed）

{
  "mcpServers": {
    "synap": {
      "command": "npx",
      "args": ["-y", "synap-mcp"],
      "env": { "SYNAP_API_KEY": "YOUR_SYNAP_API_KEY" }
    }
  }
}

キーがなくても、3 つの無料ツールは引き続き利用できます。synap_chat_completion はエラーを返し、料金は発生しません。

変数	説明
SYNAP_API_KEY	Synap キーです。Authorization: Bearer として送信されます。https://synap.linkrra.com で取得できます。
SYNAP_MCP_URL	オプションです。エンドポイントを上書きします（デフォルトは https://pool.linkrra.com/mcp）。

goose から使用する

すぐに使える goose 用のカスタムプロバイダーファイルが goose/ にあります。goose/linkrra.json を ~/.config/goose/custom_providers/ にダウンロードし、LINKRRA_API_KEY を設定して、プロバイダーとして Linkrra (Synap) を選択してください。設定手順の全文とモデル一覧は、goose/README.md をご覧ください。

支払い

• API キー（MCP および REST）。 Synap アカウントにカードまたは暗号資産でチャージします。各呼び出しは、その残高からトークンごとに課金されます。MCP では常にこの方法を使用します。
• x402、アカウント不要。 Base 上の USDC ウォレットを持つエージェントは、プレーン HTTP 経由で POST https://pool.linkrra.com/api/billing/x402/chat/completions にアクセスし、呼び出しごとに支払えます。未払いのリクエストには、支払い条件とともに 402 が返されます。このルートは REST API の一部であり、MCP ツールではありません。決済は PayAPI Market で独立して検証されています。

プロトコル

ホストサーバーは、MCP の 2 世代のプロトコルに対応しています。

• 2026-07-28（現行）： ステートレスです。server/discover を実装し、リクエストごとの _meta プロトコルバージョンを読み取ります。MCP-Protocol-Version、Mcp-Method、Mcp-Name がリクエスト本文と一致することを確認します。結果には resultType が含まれ、リスト結果には ttlMs と cacheScope も含まれます。
• 2025-11-25、2025-06-18、2025-03-26、2024-11-05： initialize ハンドシェイクを使用します。

ブリッジは両方に対応しています。レガシークライアントの場合は、initialize 中に合意したバージョンを記憶します。2026-07-28 対応クライアントの場合は、_meta のバージョンを、Streamable HTTP トランスポートで必要となる HTTP ヘッダーにコピーします。

その背後にある API

https://pool.linkrra.com/v1 は OpenAI 互換 API です。すべてのセルフホスト可能なモデルで、ツール呼び出し（tools、tool_choice）と構造化出力（response_format の json_object / json_schema）に対応しています。リクエストはストリーミングにも非ストリーミングにもできます。プロンプトと補完は保存されません。

認証

サーバーはキーをそのまま転送し、それ以外は何もしません。キーは、/v1/chat/completions に直接呼び出す場合と同様に、標準の Authorization: Bearer ヘッダーで送信されます。routes.js はそのヘッダーを変更せずに転送します。サーバーがキーを読み取ったり、保存したり、作成したりすることはありません。

サーバーを単独で実行する

npm install && npm start     # serves :8080/mcp

開発

npm test     # offline: a local mock checks the bridge's headers for both protocol eras

stdio ブリッジには Node 18 以降が必要で、依存関係はありません。

ライセンス

Apache-2.0