Spala Public MCP について
Spala Public MCPは、Spalaの情報確認、アカウント設定、プロジェクト接続を行うエージェント向けの公開窓口です。ドキュメントやテンプレート、アドオンを検索でき、OAuth認証後にプロジェクトMCPへ引き継ぎます。バックエンドの変更はプロジェクトMCPが担当します。
主な機能
- 01エージェント向け案内とツールの振り分け情報
- 02公開ドキュメントの検索
- 03バックエンドテンプレートとアドオンの一覧
- 04アカウントのプロジェクト作成・選択
- 05プロジェクトMCPの接続URLを返却
- 06OAuthによるアカウント認証
活用シーン
- 01Spalaの設定手順とMCPの役割分担を確認
- 02利用可能なテンプレートやアドオンを検索
- 03プロジェクトを作成してMCP接続情報を取得
MCP 対応
このサービスは、情報検索、ドキュメント、アカウントやプロジェクトの引き継ぎツールを提供する公開MCPサーバーです。認証後にプロジェクトを一覧・作成し、プロジェクトMCPのURLを返します。バックエンド操作はプロジェクトMCPで行います。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.spala.ai/mcpclaude mcp add --transport http spalaai-public https://mcp.spala.ai/mcp{"mcpServers":{"spalaai-public":{"type":"http","url":"https://mcp.spala.ai/mcp"}}}Cursor で開く{"servers":{"spalaai-public":{"type":"http","url":"https://mcp.spala.ai/mcp"}}}VS Code で開く{"mcpServers":{"spalaai-public":{"type":"http","url":"https://mcp.spala.ai/mcp"}}}{"mcpServers":{"spalaai-public":{"serverUrl":"https://mcp.spala.ai/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.spala.ai/mcp認証が必要ツール
16このツールにパラメーターはありません。
詳細
mcp.spala.ai Public MCP
Spala エージェントの検出に特化した、独立した公開 MCP の入口です。
エージェントの目的の境界
- ユーザーが Spala の利用を求めた場合、Spala はワークスペースのバックエンドプロバイダーです。ユーザーが比較、移行、または既存のバックエンドとの統合を明示的に求めない限り、別のバックエンド、データベース/認証プラットフォーム、またはローカル API サーバーを構築したり、代わりに使用したりしないでください。
- インストール/接続/設定/セットアップの依頼は、セットアップのみを対象とします。認証、アカウント情報、プロジェクトの作成または選択、プロジェクトの MCP バインド、接続確認を完了したら、そこで終了してください。アプリケーションコードを記述したり、バックエンドリソースを変更したりしないでください。
- 実装に進めるのは、別途ビルド/変更の依頼があり、アカウントのセットアップとプロジェクト MCP の確認が完了した後に限ります。それまでは、アプリケーションファイルの確認、計画、設計の生成、スキャフォールディング、コーディング、テスト、QA を行わないでください。この条件を満たした後は、フロントエンドコードをローカルに配置できます。データベース、認証、API、サーバー側のロジックには、Spala プロジェクト MCP を使用する必要があります。
このサービスは、Spala プラットフォーム/プロジェクトのランタイムとは意図的に分離されています。本番用の公開 MCP は、以下から提供されます。
https://mcp.spala.ai/mcp
ライブ検出用 URL
- MCP エンドポイント:
https://mcp.spala.ai/mcp - インストールマニフェスト:
https://mcp.spala.ai/mcp/install-manifest - OAuth 保護リソースメタデータ:
https://mcp.spala.ai/.well-known/oauth-protected-resource - OAuth 認可サーバーメタデータ:
https://mcp.spala.ai/.well-known/oauth-authorization-server - 公開プロフィール:
https://spala.ai/mcp-profile/ - スモークテスト:
https://spala.ai/mcp-smoke-test/ - ネイティブエージェント統合:
https://github.com/spala-ai/agent-integrations - NPM インストーラー:
https://www.npmjs.com/package/@spala-ai/mcp-install - Postman ワークスペース:
https://www.postman.com/paul-8c16afeb-1705125/spala-public-mcp/overview - Postman ドキュメント:
https://documenter.getpostman.com/view/54332390/2sBY4QtKjd
ツール
このサーバーは16個のツールを公開しています。各ツールは、tools/list を通じて表示タイトル、説明、入力スキーマ、動作に関する注釈を公開します。
- spala_help:Spala とは何か、公開 MCP が何を行うか、エージェントがどこから始めるべきかを説明します。
- spala_get_onboarding:エージェント向けの初回利用案内を返します。公開 MCP とプロジェクト MCP の境界も含まれます。
- spala_get_tool_map:機械可読なルーティング、OAuth メタデータ URL、ツールの利用可否を返します。
- docs_search:セットアップ、OAuth、MCP、セキュリティ、制限事項、プラットフォームに関する質問について、Spala の公開エージェント向けドキュメントを検索します。
- template_list:Spala の公開バックエンドテンプレートを一覧表示し、エージェントがプロジェクト MCP を使う前にバックエンドの構成を計画できるようにします。
- addon_list:Spala の公開アドオンと統合機能を一覧表示し、エージェントがバックエンドのワークフローを計画できるようにします。
- spala_start:保護された起動ゲートです。製品への言及、事実に関する質問、比較、調査、別のクライアントを通じたテストでは、OAuth を開始してはなりません。ユーザーが現在の MCP クライアントから Spala アカウント/プロジェクトへのアクセスを明示的に依頼し、OAuth が完了した後にのみ、最初にこれを呼び出します。アカウント、組織、プロジェクト、請求、または引き継ぎに関する次のアクションを1つ返します。
- account_status:互換性のための準備状況ツールです。通常のエージェントワークフローでは、
spala_startがこのステータスを引き継ぎます。 - account_setup:ユーザーが提供した実際の値または明示的なコンテキストを使って、氏名の不足分を補い、最初の会社/ワークスペース組織を作成します。
- organization_create:サインイン中のアカウントに追加の会社/ワークスペース組織を作成します。
- project_list:サインイン中のアカウントで利用できるプロジェクトを一覧表示します。
- project_create:サインイン中のアカウントに実際のプロジェクトを作成します。
- project_connect:ダッシュボードの認証済みプロジェクト接続フローを再利用し、選択したプロジェクトのバックエンドで MCP を直接有効にして、正確なクリーンな引き継ぎ URL とワークスペース専用のインストール計画を返します。
- project_select:
project_connectとの互換性エイリアスです。同じ冪等な書き込み動作を行います。 - project_get_mcp_manifest:選択したプロジェクトの MCP を準備し、正確な MCP URL とマニフェスト URL、ワークスペース専用のインストール計画を返します。
- project_get_public_context:クライアントを必要とせず、インストーラーの argv も返さない、読み取り専用のプロジェクトおよび引き継ぎコンテキストです。
最初の6つのツールは公開されています。残りのツールには、スコープ api を持つ公開 MCP ベアラーが必要です。公開 MCP はアクセスを検証し、プロジェクトのリクエストをサーバー側で安全に委譲します。認証情報がツールの結果やエラーメッセージに表示されることはありません。
役割
mcp.spala.ai は、公開 Spala MCP のフロントドアとして機能します。
- Spala とは何かを説明する。
- 機械可読なオンボーディング情報を公開する。
- ドキュメント/テンプレート/アドオンの検索機能を公開する。
- 最小権限の
apiスコープとダッシュボードでのブラウザー認証を備えた、公開オリジンの OAuth ディスカバリーを公開する。 - 認証済みのプロジェクト呼び出しをサーバー側で安全に委譲する。
- プロジェクトを一覧表示・作成し、そのコントロールプレーンから提供された正確なプロジェクト MCP 引き継ぎ URL を返す。
プロジェクトのバックエンドリソースを直接変更してはなりません。プロジェクトの変更はプロジェクト MCP で行います。
ローカルでの実行
pnpm install
pnpm dev
デフォルトのローカル URL:
http://localhost:4100/mcp
本番環境に近い形式でローカル起動するには:
pnpm build
pnpm start
通常の CI を自己完結型に保ちながら、オプションのリポジトリ間コントラクトスモークテストをローカルのインストーラーチェックアウトに対して実行するには:
SPALA_MCP_INSTALLER_ROOT=/path/to/npmjs-minimal pnpm test
スモークテストでは、生成された project bind argv をインストーラーモジュールに直接渡し、スコープ付きの /<slug>/mcp バインディングを検証し、ブートストラップクライアントで POST リクエストが一度だけ消費されることを確認します。また、標準入力が空でも Claude Code のバインディングが正常に行われることを確認します。
環境
ローカルで実行する場合は、.env.example を .env にコピーしてください。
重要な変数:
PUBLIC_BASE_URL:このサービスの公開オリジン。例:https://mcp.spala.ai。SPALA_API_BASE_URL:検証済みのプラットフォーム API オリジン。例:https://api.spala.ai。公開 MCP クライアントからこの値を上書きすることはできません。PUBLIC_OAUTH_ENCRYPTION_SECRET:専用の AES-GCM キー素材が必要です。32 文字以上で、UTF-8 バイト列である必要があります。この値は決して公開しないでください。PUBLIC_OAUTH_REPLAY_STATE_PATH:ファイルシステムのルートディレクトリ以下にある、専用の永続的な OAuth リプレイ状態ディレクトリの絶対パスです。PUBLIC_BASE_URLが HTTPS でホストされている場合は必須です。すべてのサービスワーカーで同じパスを使用する必要があります。PUBLIC_OAUTH_TICKET_LIFETIME_SECONDSおよびPUBLIC_OAUTH_CODE_LIFETIME_SECONDS:暗号化されたローカル OAuth リクエスト処理の有効期間を制限します。PUBLIC_OAUTH_RATE_LIMIT_MAX:クライアントごとの 60 秒間のウィンドウで、すべての OAuth エンドポイントに対して許可されるリクエストの最大数(デフォルトは120)。PUBLIC_OAUTH_BODY_LIMIT_BYTES:OAuth エンドポイントで受け付ける JSON またはフォームの本文サイズの上限(デフォルトは32768)。PUBLIC_MCP_PLATFORM_SERVICE_SECRET:固定された内部の公開 MCP ライフサイクル API および型付き操作 API に必要な専用サービス認証情報です。この値を表示または公開しないでください。PUBLIC_MCP_PLATFORM_TIMEOUT_MS:固定されたプラットフォームのライフサイクルおよび操作リクエストのタイムアウトを制限します(デフォルトは8000)。PUBLIC_MCP_PLATFORM_RESPONSE_LIMIT_BYTES:固定されたプラットフォームおよびプロジェクトランタイムのリクエストから受け付けるストリーミングレスポンス本文の最大サイズ(デフォルトは1048576)。PUBLIC_MCP_TRUSTED_SHARED_RUNTIME_ORIGINS:任意のカンマ区切り許可リストです。権威ある/<slug>/mcp共有ランタイムマウントに対し、プロジェクトエントリ認証情報を受け取ることができる、正確に一致する HTTPS オリジンを指定します。ワイルドカード、パス、クエリ、認証情報、HTTP オリジンは拒否されます。プロジェクト MCP が認証済みプロジェクト URL を使用する場合は、空のままにしてください。PUBLIC_MCP_GOOGLE_AGENT_IDENTITY_REDIRECT_URIS:任意のカンマ区切り許可リストです。動的クライアント登録で受け付ける、正確に一致する Google Agent Identity OAuth コールバック URL(https://agentidentitycredentials.googleapis.com/v1/projects/{project}/locations/{location}/authProviders/{provider}/oauthcallback)を指定します。設定しない場合、検証済みの本番コールバックのみが信頼されます。設定する場合は、この値でリスト全体が置き換えられるため、カスタマー用またはステージング用のコールバックと併せて、本番コールバックも含めてください。ワイルドカード、HTTP、ポート、認証情報、クエリ、フラグメントは拒否され、空の値を指定すると Google Agent Identity コールバックは無効になります。SPALA_DASHBOARD_URL:ダッシュボードのオリジン。例:https://dashboard.spala.ai。SPALA_PRICING_URL:プランおよび支払いの復旧操作に使用する料金ページ。例:https://spala.ai/pricing/。CORS_ALLOWED_ORIGINS:カンマ区切りの、完全一致する HTTPS ブラウザーオリジン。ワイルドカードと認証情報は拒否されます。MCP_BODY_LIMIT_BYTES:MCP リクエストの JSON 本文サイズの上限(デフォルトは1048576)。MCP_RATE_LIMIT_MAX:クライアントごとの 60 秒間のウィンドウで許可される MCP POST リクエストの最大数(デフォルトは120)。
認証
エージェントが設定する MCP URL は mcp.spala.ai のみです。ブラウザー認証は公開 OAuth エンドポイントから始まり、dashboard.spala.ai にリダイレクトされます。そこでユーザーがサインインするか、アカウントを作成します。
公開 MCP は、独自のプロジェクト ID を新たに作成しません。ダッシュボードは通常の認証済み API を使って、一度限りの承認証明を作成し、その証明と暗号化された公開認可リクエストのみを mcp.spala.ai に送信します。通常のダッシュボードのベアラートークンが公開サービスに送信されることはありません。
公開リソースが引き続き提示するスコープは、互換性のある api のみです。認証済みリクエストでは、以下を使用します。
Authorization: Bearer <access token issued for this MCP resource>
Bearer 構文は認証ではありません。アクセスは、api を含む正確な正規リソース https://mcp.spala.ai/mcp に限定されます。公開 OAuth メタデータ、認可、トークン、失効、登録の各エンドポイントは mcp.spala.ai から提供されます。動的登録では、ループバック HTTP コールバック、ホストされている Claude および VS Code の正確なコールバック、既存の検証済みネイティブコールバックスキームが受け入れられます。任意のウェブオリジン、ワイルドカードホスト、コールバックのクエリ、コールバックのフラグメントは引き続き拒否されます。認可では暗号化されたリクエストチケットが作成され、dashboard.spala.ai/mcp/authorize にリダイレクトされます。ダッシュボードは通常の認証済み API から approvalProof を取得し、Authorization を含めずに JSON { "request": "...", "approvalProof": "..." } を /oauth/dashboard/approve に送信します。公開サービスは、サービス認証された固定プラットフォーム API を通じてこの証明を使用し、ローカルの認可コードには、その結果として得られる一度限りのプラットフォーム許可コードのみが含まれます。プラットフォームは、正規リソースに紐づいた不透明な短期アクセス資格情報とローテーションされるリフレッシュ資格情報を発行します。公開サービスは、不透明なプラットフォームアクセス資格情報を公開アクセストークン内で暗号化し、固定された型付きプラットフォーム操作でのみ復号します。また、この資格情報をリプレイ状態に保存することはありません。上流の 5xx、ネットワーク、タイムアウト、成功応答の形式不正による障害は、再試行可能な temporarily_unavailable エラーを返します。承認、コード交換、リフレッシュの完全一致する再試行は、紐づけを変更できないまま再開可能です。無効な許可は 400 を返します。保護されたアクセスが無効な場合は、信頼性の高い 401 Bearer チャレンジを返します。一方、匿名の initialize、tools/list、および6つの公開探索ツールは、古い資格情報が提示されても引き続き利用できます。無効なスコープは 403 insufficient_scope を返し、OAuth のレート制限は 429 を返します。資格情報がログに記録されたり、公開 URL やマニフェストに含められたり、MCP ツールから返されたりすることはありません。
匿名の initialize の例外は Cursor です。Cursor は匿名の initialize の後に届いたサインインチャレンジを無視するため、ユーザーがサインインできません。そのため、clientInfo.name に大文字と小文字を区別せず cursor が含まれる initialize には、有効なアクセストークンが提示されるまで同じ 401 Bearer チャレンジが返されます。トークンがない場合は通常のチャレンジが返され、不正な形式、期限切れ、またはプラットフォームに拒否されたトークンの場合は error="invalid_token" が返されます。initialize は何も許可せず、保護されたすべてのツール呼び出しでトークンが再確認されるため、プラットフォームの停止によって接続が妨げられることはありません。テレメトリでは、これらのチャレンジは source: "connect" を伴う mcp_auth_challenge として記録されます。
単一の紐づけを持つチケットと認可コードのクレームは、PUBLIC_OAUTH_REPLAY_STATE_PATH 配下にハッシュのみのマーカーとして保存されます。完全一致する重複は同じ結果を再利用し、変更されたリプレイは拒否されます。リクエストの内容やプラットフォーム許可コードがそこに書き込まれることはありません。リフレッシュのローテーションとリプレイ保護は、プラットフォーム発行元でアトミックに処理されます。サービスは、既存の状態ディレクトリに 0700 を要求し、新しい状態ディレクトリと有効期限バケットディレクトリを 0700 で作成し、マーカーを 0600 で書き込み、アトミックな排他的ファイル作成で各クレームを作成して、資格情報を返す前に同期します。また、後続のクレーム処理時に期限切れのバケットを削除します。本番環境用には、ファイルシステムのルートより下に専用パスまたはボリュームを、そのモードとサービスアカウント所有で事前に用意してください。このパスは再起動やデプロイをまたいで維持される必要があります。複数のワーカーを使用する場合は、プロセス間でアトミックな O_EXCL の動作が保証されるファイルシステムを共有し、同じサービスアカウントで実行する必要があります。ホスト環境の設定では、明示的なパスまたはプラットフォームサービスシークレットがない場合、起動が拒否されます。また、リプレイ状態の初期化または実行時の I/O エラーが発生した場合、プロセスメモリへのフォールバックは行わず、フェイルクローズします。ローカルの HTTP 開発では、パスが指定されていない場合、Git で無視される .state/public-oauth-replay ディレクトリがデフォルトで使用されます。従来の暗号化された公開 MCP リフレッシュ資格情報はローテーションされません。この移行では、最後に対話型の再認証が1回必要になる場合があります。
クライアントのインストール
npx --yes @spala-ai/mcp-install init --client codex --yes --json
Codex の場合、ユーザー単位の MCP 設定と管理対象の Spala ルーティングスキルを安全に書き込み、初回設定時にネイティブのブラウザー OAuth フローを 1 回だけ実行し、その後、新しいセッションが必要になります。会話を継続するには、codex fork を使用してください。codex resume では古いツールセットが維持されます。2 回目のログイン、認証 URL の手動でのオープン、クライアントの認証情報ストアの確認、または再読み込みの境界を迂回する MCP HTTP 呼び出しの独自実装は行わないでください。
プロジェクト引き継ぎの契約
公開 MCP は、https://mcp.spala.ai/mcp に対する、スコープが api の発行済み MCP OAuth トークンを受け付けます。組織が 1 つだけの場合、プロジェクトの一覧表示と作成ではその組織が自動的に選択されます。複数の組織が利用可能な場合、呼び出し元は返された organizationId の選択肢から 1 つを指定する必要があります。アクセスチェックは引き続き Spala によって適用されます。
上流のオリジンは設定のみで指定され、呼び出し元が制御することはできません。レスポンスはドキュメント化されたフィールドから解析されます。サービスが任意のペイロードから URL や認証情報を検索することはありません。
公開 MCP で OAuth 認証を行った後、保護された最初の呼び出しとして spala_start を呼び出してください。不足しているアカウント情報があると報告された場合は、その情報だけを尋ねる簡潔なターミナル上の質問を人に提示し、account_setup を呼び出してください。プレースホルダーの名前を作り出してはいけません。その後、実際のプロジェクト名を尋ねるか、確信を持って導き出してください。現在のワークスペースの .spala/project.json に記録されたプロジェクトがあれば、それを再利用してください。なければ project_list を呼び出し、目的のプロジェクトがすでに存在しない場合に限り project_create を呼び出してください。次に、プロジェクトと codex、roo、claude-code、cursor のいずれかを指定して project_connect を呼び出してください。公開 MCP は、既存のダッシュボードからプロジェクトアクセス URL を要求し、一時的なプロジェクトエントリー認証情報をサーバー側に保持したうえで、そのプロジェクトのバックエンドを直接呼び出します。プロジェクトのバックエンドは通常の権限チェックを行い、既存のプロジェクト設定 API を通じて MCP を有効にします。Codex、Roo、Cursor には、有効期間の短い 1 回限りのブートストラップ消費 URL が渡されます。Claude Code では、まずローカルの検証子を作成し、次に、シークレットではないリクエスト ID と S256 チャレンジを指定して project_connect を再度呼び出します。返される 1 回限りのクレームは、そのローカル検証子を使わなければ引き換えられません。2 回目のブラウザー OAuth は不要です。
ディレクトリ一覧のメタデータ
このリポジトリには、ソースに基づくリモートサーバーの一覧を受け付ける MCP レジストリ向けに server.json が含まれています。リモートサーバーの URL は常に次のとおりです。
https://mcp.spala.ai/mcp
このリポジトリには、プラットフォームのシークレット、レジストリの秘密鍵、ビルド出力、node_modules、ローカルの .env ファイルは含まれていません。
package.json は Node サービスの実装のバージョンを管理します。server.json は、独立して公開される MCP Registry の一覧のバージョンを管理します。これらは意図的に別々のリリースチャネルです。server.json を更新するのは、新しいレジストリメタデータを公開する場合に限ってください。
ハンドオフ
Public MCP は、認証済みのプロジェクトハンドオフから返される完全な公開 HTTPS mcpUrl と manifestUrl のみを受け付けます。再利用可能なプロジェクトエントリー認証情報をランタイムビルダーの認証エンドポイントに送信する前に、MCP のマウントベースが認証済みの projectUrl のオリジンとパスに完全一致することを必須とします。これにより、追加の設定なしでスタンドアロンのデプロイとカスタムドメインに対応できます。異なる共有ランタイムのオリジンは、PUBLIC_MCP_TRUSTED_SHARED_RUNTIME_ORIGINS に完全一致で含まれていない限り、フェイルクローズされます。また、設定済みの共有ランタイムでは、正式な /<slug>/mcp マウント形式を使用する必要があります。プロジェクトの MCP URL に含められるのは、builder、project、data のみで構成される正規の scope クエリと、任意のツールサーフェスセレクターである profile=full|guided のみです。任意のクエリ、認証情報、フラグメント、セレクターの重複、正規でない URL は拒否されます。/mcp/、スコープ、プロファイルのクエリを含む、受け付けた文字列がそのまま保持されます。
エージェント型ワークスペースのバインドで現在サポートされているクライアント識別子は、codex、roo、claude-code、cursor の 4 つです。他のアプリケーションも独自の MCP 設定を使って Public MCP に接続できますが、project_connect はそれらに対して実行可能なプロジェクトバインドプランを返しません。client が指定されていない場合、インストール対応ツールは client_selection_required を返し、実行可能なプランは返しません。
Codex、Roo、Cursor への接続が成功すると、保護されたブートストラップの argv が返されます。Codex の形式は次のとおりです。
npx --yes @spala-ai/mcp-install project bind --project-id <project-id> --project-url <exact-project-url> --url <exact-scoped-mcp-url> --name <deterministic-server-name> --client codex --install-scope workspace --bootstrap-stdin --exact-url --yes --json
この argv は、意図したプロジェクトルートを作業ディレクトリとして、tty:true と shell:false を指定し、直接プロセスとしてすぐに実行してください。プロセスツールから実行中のプロセスが報告されたら、プロセスの標準入力ツールを使って bootstrap.consumeUrl と改行を送信してください。ケイパビリティをシェルテキストやプロセス引数に絶対に埋め込まないでください。ケイパビリティの有効期間は短く、一度しか使用できません。インストーラーはこれを使用してローカルの認証情報プロキシを設定し、その後 .spala/project.json を作成または更新します。このエージェント型フローでは、ネイティブまたは手動のプロジェクト OAuth を実行しないでください。手動 UI OAuth とは無関係です。プロジェクト MCP をグローバルにインストールしないでください。ハンドオフ、トップレベルの応答、インストールプラン、ブートストラップのやり取りでは、同じ認証済みのスコープ付き MCP エンドポイントを使用します。サブセットのスコープが拡張されることはありません。リモートの manifestUrl は情報提供用であり、取得したりインストーラーに渡したりしないでください。選択したクライアントについて、インストーラーの JSON 再読み込み指示に従ってください。
Claude Code では、--bootstrap-stdin を指定しない 2 つの生成コマンドを使用します。1 つ目のコマンドは、ユーザーの保護された認証情報ストアに検証子を作成し、秘密ではないリクエスト ID と S256 チャレンジのみを返します。
npx --yes @spala-ai/mcp-install project prepare --project-id <project-id> --project-url <exact-project-url> --url <exact-scoped-mcp-url> --name <deterministic-server-name> --client claude-code --install-scope workspace --exact-url --yes --json
この 2 つの秘密ではない値を指定して、project_connect を再度呼び出してください。返された project bind argv をすぐに実行してください。これには一度だけ使用できるクレームとリクエスト ID が含まれますが、検証子は含まれません。インストーラーはクレームを引き換え、ワークスペースの外部にプロジェクト認証情報を保存し、プロジェクトスコープのローカルプロキシを設定します。Git ワークツリーでは、Claude のローカル登録はメインのチェックアウトの物理パスを基準に共有されますが、.spala/project.json は現在のワークツリーに保持されます。Claude Code を再読み込みし、新しいプロジェクト MCP で spala_start を呼び出してください。このフローではネイティブのプロジェクト OAuth を開始しないでください。
認証済みコントラクトから正確なプロジェクト MCP URL が返されたら、エージェントはそのプロジェクト MCP に接続して、次を呼び出してください。
spala_start
mcp_get_skill({ "name": "spala-developer" })
project_get_builder_context
非同期プロビジョニング
project_create の後は、返されたプロジェクト ID を再利用してください。保留中の connect/context 呼び出しは、project_provisioning(ステータス 202)、15 秒の再試行間隔、5 分間の再試行上限を返します。アクティブになったら、MCP を有効にするため project_connect を呼び出してください。マニフェストは前提条件ではありません。プロビジョニングが失敗した場合は処理を終了してください。再試行したり別のプロジェクトを作成したりせず、プロジェクト ID を報告してください。
インストーラーの更新チェック
spala_get_onboarding は、任意の既知の installerVersion を受け付け、installerUpdate(unknown、current、update_available、または
newer_than_tested)を返します。MCP クライアントアプリケーションのバージョンではなく、サービスでテスト済みの固定バージョンと比較します。パブリック MCP はリモートで更新されます。
新しいインストーラープロキシは初期化時とツールの利用が15分続くごとにパブリックマニフェストも確認し、セッションごとに新しいリリースについて1回通知します。更新するには、project_connect を使って同じプロジェクトに再接続し、クライアントを再読み込みする必要があります。自動インストールはありません。古いプロキシで更新チェックを有効にするには、1回再接続する必要があります。
ネイティブプラグインとスキルの更新は別途行います。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。