ClaudeなどのMCPクライアントからVULKで構築する:コネクタをツールごとに解説

2026年10月10日、稼働中のサーバーとその背後のコードに対して検証。

VULKはリモートMCPサーバーを運用しています。Claude、Claude Code、またはリモートMCPサーバーに対応した別のアシスタントにアドレスを1つ追加し、VULKに一度サインインすれば、アシスタントがプロジェクトの一覧を出し、ファイルを読み、クレジットを確認し、あなたに代わってビルドを開始・続行できます。何もインストールする必要はなく、APIキーを貼り付ける必要もありません。

アドレスは次のとおりです。

https://app.vulk.dev/mcp

この記事では、サーバーが公開しているすべてのツールを挙げ、稼働していることを証明する実際のレスポンスを示します。

稼働している証拠

アカウントがなくても、誰でもサーバーを確認できます。サインイン用のメタデータを問い合わせてみてください。

curl https://app.vulk.dev/.well-known/oauth-protected-resource

2026年10月10日の応答は次のとおりでした。

{
  "resource": "https://app.vulk.dev/mcp",
  "authorization_servers": ["https://app.vulk.dev"],
  "scopes_supported": ["projects.read", "usage.read", "projects.write"],
  "bearer_methods_supported": ["header"],
  "resource_name": "VULK"
}

トークンなしでサーバー本体を呼び出すと、401と、クライアントをそのメタデータへ案内するWWW-Authenticateヘッダーで拒否されます。MCPクライアントは、このヘッダーによって相手にサインインしてもらう必要があることを知ります。同じサーバーはhttps://mcp.vulk.dev/mcpでも応答します。

サインインの仕組み

接続には標準のOAuthを使い、MCP仕様が定める検出と登録の手順に従います。

• クライアントは登録エンドポイントを通じて自動的に自らを登録するので、クライアントIDをコピーする必要はありません。
• 認可コードフローではS256によるPKCEが必須で、クライアントはシークレットなしで認証します。これは手元のマシンで動くアプリにとって正しいモデルです。
• アクセスはリフレッシュトークンで更新されますが、何度更新しても接続の有効期間は最長90日です。その後は改めて承認します。
• サーバーはMCPプロトコルのバージョン2025-06-18、2025-03-26、2024-11-05に対応しています。

接続すると、VULKはアシスタントができるようになることを正確に列挙した同意画面を表示します。読み取りだけを求めるアシスタントには読み取りの権限だけが与えられ、画面には、その接続では何も作成、変更、公開、削除できないことが示されます。同じ画面にはもう1つ注意書きがあります。表示される名前はアプリが自分で名乗った名前であり、VULKはそれを検証できません。ですから、自分で今始めた接続だけを承認してください。

接続中のアプリはすべてSettings › Integrations › Connected appsで確認でき、いつでも削除できます。削除したアプリはすぐにアクセスを失います。接続できるアプリは最大50個、同時に待機できる承認画面は最大20個です。

9つのツール

6つのツールは読み取りだけを行います。3つは作業の開始、続行、停止ができます。

各ツールは必要な権限を宣言しており、その権限なしの呼び出しはサーバーが拒否します。読み取り専用の接続には、ビルド用のツールが表示されることすらありません。

アシスタントからのビルドの流れ

ビルドにはミリ秒ではなく分単位の時間がかかるため、処理は2つに分かれています。

1. アシスタントは、最大8,000文字のあなたの指示と、この1回の操作のための新しいUUIDであるrequest_idを付けて、create_projectを呼び出します。
2. VULKはプランとクレジットを確認し、受付票で応答します。受付票にはリクエストID、プロジェクトID、エディターへのリンクが含まれます。受付票はビルドが始まったことを意味し、終わったことを意味するわけではありません。
3. アシスタントは作業が終わるまで同じrequest_idでget_operationを呼び出し、VULKがあなたに尋ねる質問があれば伝えます。

レスポンスが失われた場合、アシスタントは同じrequest_idと同じ引数で再試行し、VULKはそれを2つ目のリクエストとして開始・課金するのではなく、同じリクエストとして扱います。約20秒以内にVULKがリクエストを確認できなかった場合、応答はunconfirmedとなり、アシスタントは推測せずにget_operationで状態を読み直します。

できあがるプロジェクトは普通のVULKプロジェクトです。あなたのアカウントに表示され、いつでもエディターで開けます。

組み込みの安全策

いくつかの線は意図的に引かれています。それもドキュメントの上だけでなく、コードの中で。

• サイトを公開するツールはありません。公開はエディターで行います。何が公開されるのかを、そこで確認できます。
• クレジットを購入したりプランを変更したりするツールはありません。create_projectとcontinue_projectは、エディターに同じ依頼を入力した場合とまったく同じように、プランにすでに含まれているクレジットを使います。残高が足りなければ、VULKは理由を添えて断ります。
• プロジェクトを削除するツールはありません。continue_projectで送った指示は、エディターに入力した同じ依頼と同様に、プロジェクト内のファイルを変更したり削除したりできますが、プロジェクトそのものを削除するツールはありません。

モデルのために作られた応答

アシスタントはツールが返すすべてのバイトにコストを払うので、応答には上限があり、切り詰めたときはそう伝えます。プロジェクト一覧は50件、ファイル一覧は500件、1つのファイルは200,000文字で止まり、その場合はtruncatedフラグが付きます。すべての結果は2通りで返ります。どのクライアントでも読めるテキストと、2025-06-18プロトコルのクライアント向けの構造化データです。各ツールはそのデータの正確な形を出力スキーマとして公開しており、テストがその形を守らせています。各ツールには人が読めるタイトルと、読み取り専用、破壊的、冪等であることを示すヒントも付いています。

失敗は、会話を終わらせてしまうプロトコルエラーではなく、「そのファイルはありません。先にファイル一覧を取得してください」のような、モデルが読めるツールの結果として返ります。

設定方法

Claude(Webとデスクトップ):Customize、Connectorsの順に開き、上記のアドレスでカスタムコネクタを追加してから、Connectを選び、開いたVULKのウィンドウで承認します。

Claude Code:

claude mcp add --transport http vulk https://app.vulk.dev/mcp

次に/mcpを実行してvulkを選び、ブラウザが開いたらサインインします。

その他のアシスタント:サインイン付きのリモートサーバーに対応したクライアントであれば、同じアドレスをリモートHTTP MCPサーバーとして追加します。クライアントは承認のためにブラウザでVULKを開きます。手順はMCPドキュメントにあります。