クライアントを接続する
この機能は現在開発中であり、まだ公開されていません。記載内容は今後変更される可能性があります。
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クライアントが自動で行ないます。ユーザーがトークンを手動で扱う必要はありません。
「許可する環境」には、操作しているユーザー自身がアクセスできる有効な環境のみが表示されます。利用できる環境がない場合は、プロジェクトへのアクセス権を確認してください。
接続できるMCPクライアント
ベースマキナのMCPサーバーは、OAuthのクライアント登録にClient ID Metadata Document（CIMD）方式のみを採用しています。CIMDは、クライアントが自身の情報を公開しているHTTPS URLを、そのままクライアントIDとして扱う方式です。
動的クライアント登録（Dynamic Client Registration）には対応していません。そのため、接続にはCIMDに対応したMCPクライアントが必要です。Claudeなど、対応済みのクライアントから接続してください。
アクセストークンの有効期限
接続を許可すると、MCPクライアントにはアクセストークンとリフレッシュトークンが発行されます。アクセストークンの有効期限は900秒（15分）です。
有効期限が切れると、MCPクライアントがリフレッシュトークンを使ってアクセストークンを自動的に取得し直します。ユーザーが接続を再度許可する必要はありません。リフレッシュトークンの有効期限は30日で、アクセストークンを取得し直すたびに更新されます。30日以上クライアントを利用しなかった場合は、再度接続を許可してください。
アクションがツールになる仕組み
許可した各環境のアクションが、1つずつMCPのツールに変換されます。ただし、無効化されたアクションや、環境で無効・非表示に設定されたアクション、使用するデータソースが接続されていないアクションはツールになりません。詳細はアクションを実行するを参照してください。
各ツールの内容は次のように決まります。
| ツールの項目 | 内容 |
|---|---|
name | {環境名}__{識別子} の形式（例: production__send_email）。環境名は小文字化され、半角英数字・_・- 以外の文字は _ に置き換えられます。 |
description | アクション名・識別子・環境名・説明文をラベル付きで列挙します（例: アクション名: メール送信 / 識別子: send_email / 環境: 本番 / 説明: ユーザーにメールを送信する）。アクション名・説明文が空の場合は、その行を省略します。実行できないツールは、先頭行に実行できない理由を含めます。 |
inputSchema | アクションの入力パラメーターの定義（JSON Schema）。実行できないツールは空のスキーマになります。 |
複数の環境を許可した場合、同じアクションでも環境ごとに別々のツールになります。ツール名の先頭に環境名が付くため、どの環境のアクションかを区別できます。
環境名が日本語のみで構成される場合、ツール名に使える文字が残らないため、環境名の代わりに環境IDを使います。cl5hr5q23akg00ca2bug__send_email
のような形式です。環境名を日本語で設定している場合は、こちらの形式になります。正規化した環境名が他の環境と重複する場合は、環境名のうしろに環境IDをつけて一意にします。
ツール名が長い場合
MCPクライアント側の制約により、ツール名は64文字以内である必要があります。この長さに収まるよう、ベースマキナ側で次のように調整します。
- 環境名の部分が長い場合は、42文字までに切り詰めます
- 識別子が残りの長さに収まらない場合や、識別子に半角英数字・
_・-以外の文字が含まれる場合は、識別子の代わりにアクションの内部IDを使います
内部IDを使ったツールは、ツールの説明にその旨を記載します。ベースマキナの画面でアクションを探すときは、ツールの説明に記載されている識別子を利用してください。
接続したクライアントからツールを実行する方法は、アクションを実行するを参照してください。