クライアントを接続する
⚠️
この機能は現在開発中であり、まだ公開されていません。記載内容は今後変更される可能性があります。
ClaudeなどのMCP（Model Context Protocol） (opens in a new tab)クライアントから、ベースマキナのMCPサーバーに接続する手順を説明します。機能の概要はRemote MCPとはを参照してください。
接続先URL
MCPクライアントには、次のURLをベースマキナのMCPサーバーとして登録します。
https://platform.basemachina.com/mcpこのエンドポイントは、JSON-RPCをStreamable HTTPで扱うMCPサーバーです。プロジェクトや環境はURLには含めず、後述の同意画面で許可した環境から決まります。
接続の手順
- MCPクライアントに、接続先URL
https://platform.basemachina.com/mcpを登録します。 - クライアントがOAuthの認可フローを開始すると、ブラウザでベースマキナの画面が開きます。ログインしていない場合はログインを求められます。
- 「アクセスを許可」の画面で、接続を許可するクライアントの情報（Client ID・Redirect URI）と「許可する環境」が表示されます。
- 公開を許可する環境を選択し、「許可する」を選択します。
- クライアントに戻り、許可した環境のアクションがツールとして取得できるようになります。
OAuthの認可コードの取得やアクセストークンの交換は、MCPクライアントが自動で行ないます。ユーザーがトークンを手動で扱う必要はありません。
「許可する環境」には、操作しているユーザー自身がアクセスできる有効な環境のみが表示されます。利用できる環境がない場合は、プロジェクトへのアクセス権を確認してください。
アクションがツールになる仕組み
許可した各環境のアクションが、1つずつMCPのツールに変換されます。各ツールの内容は次のように決まります。
| ツールの項目 | 内容 |
|---|---|
name | {環境名}__{アクションID} の形式（例: production__send_email）。環境名は小文字化され、半角英数字・_・- 以外の文字は _ に置き換えられます。 |
description | アクション名・識別子・環境名・説明文をラベル付きで列挙します（例: アクション名: メール送信 / 識別子: send_email / 環境: 本番 / 説明: ユーザーにメールを送信する）。アクション名・説明文が空の場合は、その行を省略します。 |
inputSchema | アクションの入力パラメーターの定義（JSON Schema）。 |
複数の環境を許可した場合、同じアクションでも環境ごとに別々のツールになります。ツール名の先頭に環境名が付くため、どの環境のアクションかを区別できます。
環境名が日本語のみなど、ツール名に使えない文字だけで構成される場合や、正規化した名前が他の環境と重複する場合は、環境を識別する値をつけて一意なツール名にします。
接続したクライアントからツールを実行する方法は、アクションを実行するを参照してください。