NexaLayer

NexaLayer MCP Server

このディレクトリには、MCP サーバーパッケージと実装が含まれています。リポジトリの概要、インストール方法、16 種類のツールの全カタログ、バックエンドとの関係については、ルート README をご覧ください。

MCP クライアントを NexaLayer の製品、セッション、稼働状況、使用状況、支出管理に接続します。

{
  "mcpServers": {
    "nexalayer": {
      "command": "npx",
      "args": ["-y", "@nexalayer/mcp"],
      "env": { "NEXALAYER_API_KEY": "agk_your_key" }
    }
  }
}

サーバーはプロトコルメッセージのみを標準出力に書き込みます。API エラーは MCP ツールの結果を通じて返されます。ツールのアノテーションは、読み取り、有料の書き込み、ポリシーの変更、破壊的なクリーンアップを示すため、互換性のあるクライアントは承認ポリシーを適用できます。

ツール

• 読み取り：製品と正確な価格、セッションの詳細、稼働状況、使用状況、予算、アラート、残高、取引。
• 有料の書き込み：セッションの作成またはローテーション。一意の idempotency_key を使用し、オーナーの承認を得てください。
• ポリシーの書き込み：API キーと日次予算の上限を変更します。オーナーの承認が必要です。
• クリーンアップ：タスク終了時にセッションを終了します。早期終了しても返金されるとは限りません。アップストリームが停止している場合、最初の終了試行時点で課金が停止し、NexaLayer がバックグラウンドで解放を再試行します。
• サポート（無料）：nexalayer_check_status、nexalayer_known_issues、nexalayer_report_issue、nexalayer_get_ticket。

nexalayer_list_products は、カーソルによるページネーションに対応した簡潔なカタログを返します。デフォルトでは、現在利用可能な製品を 20 件返し、type、country、in_stock、limit、cursor に対応します。また、内部向けの価格情報とサプライヤーのフィールドは除外されます。

nexalayer_create_session は、アカウント残高に対して課金されます。現在の見積もりと予算を確認してから、呼び出す前にオーナーの承認を得てください。POST /sessions は include_credentials を受け付けず、プロキシの認証情報を省略します。PRICE_MISMATCH（409）：価格を再確認し、1 回だけ再試行してください。BUDGET_EXCEEDED と INSUFFICIENT_BALANCE（402）：オーナーに確認し、再試行しないでください。

nexalayer_get_session と nexalayer_rotate_session は、省略可能な include_credentials（デフォルトは false）を受け付け、API に渡します。include_credentials=true でない限り、認証情報は省略されます。決してログに記録しないでください。

購入前には必ず nexalayer_list_products を読み取ってください。現在の openAgent に基づく見積もりと在庫状況が返されます。限定静的プロキシセッションの価格は 月額 $1.43～$5.86 です（ローンチ価格。最新情報はライブ API が優先されます）。

nexalayer_list_products → nexalayer_get_budget → owner approval
→ nexalayer_create_session → nexalayer_get_session → health/usage → nexalayer_terminate_session

一般的な API エラーコードには、AUTH_INVALID_KEY、INSUFFICIENT_BALANCE、BUDGET_EXCEEDED、PRICE_MISMATCH、IDEMPOTENCY_CONFLICT、RATE_LIMIT_EXCEEDED があります。

PRICE_MISMATCH は HTTP 409 です。価格を再確認し、1 回だけ再試行してください。BUDGET_EXCEEDED と INSUFFICIENT_BALANCE は HTTP 402 です。オーナーに確認し、再試行しないでください。

エラーとサポート

API 呼び出しに失敗すると、1 行の概要と、structuredContent.error に含まれる完全な NexaLayer エラーオブジェクトを伴う MCP ツールエラー（isError: true）が返されます。エラーオブジェクトには、code、retryable、retry_after、suggested_action、side_effects、doc_url、known_issue_id、request_id が含まれます。メッセージのテキストではなく、これらのフィールドに基づいて処理を分岐してください。

エラーの内容が明確でない場合：

follow error.suggested_action → nexalayer_check_status → nexalayer_known_issues(error_code)
→ nexalayer_report_issue → poll nexalayer_get_ticket after next_check_after_seconds

サーバーは、直近で確認したリクエスト ID とエラーコードを最大 20 件保持し、MCP クライアント名とパッケージバージョンとともに、自動的に nexalayer_report_issue に添付します。API キー、プロキシのパスワード、full_url をチケットに記載しないでください。応答目標は早期アクセス向けの目安であり、保証ではありません：S1 は 4 時間、S2 は 24 時間、S3 は 3 営業日、S4 は可能な範囲で対応します。人によるサポート窓口：[email protected]（Telegram @LEWISMIN）。

Docker

リポジトリのルートから stdio MCP サーバーをビルドします：

docker build -t nexalayer-mcp ./mcp

このコンテナは、認証情報なしで起動し、ツールカタログを公開できます。そのため、MCP ディレクトリやクライアントが安全に内容を確認できます：

docker run -i --rm nexalayer-mcp

NexaLayer ツールを呼び出すときは、実行時にのみ API キーを渡してください：

docker run -i --rm \
  -e NEXALAYER_API_KEY="$NEXALAYER_API_KEY" \
  nexalayer-mcp

NEXALAYER_BASE_URL は引き続き省略可能です。このイメージは stdio を使用し、ネットワークポートを公開せず、認証情報も含みません。

API キーと一度限りのトライアルクレジットを https://nexalayer.net/agents?source=mcp-readme から申請してください。