MINARAカスタム MCP
URL・カスタム設定・JSON インポートで、信頼する MCP サーバーを追加する方法。
カスタム MCP は、信頼するリモートのツールサーバーに Minara を接続します。プリフライトチェックを通過したツールはカタログに登録されます。有効化するまでは無効状態のままです。
コネクター → コネクターを追加 → MCP サーバーを追加 を開いてください。
URL で追加
HTTPS の Streamable HTTP または SSE サーバーには URL で追加 を使います。次の項目を入力してください。
- サーバー名
- サーバー URL
- メモ（任意）
- OAuth クライアント ID（任意）
- OAuth クライアントシークレット（任意）
OAuth の各フィールドは、3 つのモードに対応しています。
| 入力内容 | 認証モード |
|---|---|
| クライアント ID なし | CIMD または DCR と PKCE を使用した OAuth ディスカバリー |
| クライアント ID のみ | Authorization Code と PKCE を使ったパブリッククライアント |
| クライアント ID とシークレット | ゲートウェイ上でコード交換を行うコンフィデンシャルクライアント |
クライアント ID なしでシークレットだけを入力することはできません。シークレットは書き込み専用です。ゲートウェイがゲートウェイクレデンシャルストアに暗号化して保存します。Minara は API・診断・エクスポート・ログのいずれを通じても返しません。
カスタム設定
カスタムアイコン・メモ・非センシティブなパブリックヘッダーを指定して HTTP または SSE エンドポイントに接続する場合は、カスタム設定 を使います。このフォームでは、authorization・Bearer・API キー・パスワード・シークレットに関するヘッダーは入力できません。サーバーが OAuth クライアントシークレットを必要とする場合は、URL で追加 を使ってください。
JSON または JSONC のインポート
インポーターは mcpServers マップと servers マップを受け付けます。保存前にすべてのエントリをプレビューで確認できます。名前が重複している場合、デフォルトでは スキップ が選択されます。意図的に上書きする場合は 置換 を選んでください。
リモートエントリには HTTPS HTTP または SSE トランスポートを使用できます。インポーターは npx・pnpm dlx・uvx とレジストリパッケージを組み合わせた、限定的な stdio 定義を認識します。このリリースでは、ゲートウェイに対応する隔離ランナーがない限り stdio の実行は無効です。ジェイルが利用できない場合、プリフライトチェックは安全側（失敗）に倒れます。
JSON インポートでは、埋め込みシークレット・認証値・Bearer トークン・API キー・パスワードは拒否されます。コンフィデンシャルな OAuth クライアントを追加する場合は URL で追加 を使ってください。
プリフライトとツールのレビュー
保存前に Minara は次の処理を行います。
- 設定を正規化します。
- トランスポートとネットワーク接続先を検証します。
- 必要に応じて OAuth メタデータを検索します。
- MCP セッションを初期化し、
tools/listをリクエストします。 - 各ツール・スキーマ・リスクを表示します。
- 確認後にのみ設定を保存します。
保存のいずれかのステップが失敗した場合、Minara は新しい設定とそのクレデンシャル参照をロールバックします。
ツールはデフォルトでオフになっており、有効化すると 毎回確認 が適用されます。スキーマが変更されると、対象の書き込みツールは新しいスキーマをレビューするまで一時停止されます。カスタム MCP ツールは任意の資金移動を直接開始できません。x402 の料金は独立した支払いゲートで処理され、支払いごとの確認または一致する事前承認が必要です。Automation・機関投資家モードのアナリスト・サブエージェントはカスタム MCP ツールを呼び出せません。
ネットワーク制限
リモート MCP の URL は HTTPS を使う必要があります。Minara は、URL クレデンシャル・クエリトークン・ループバック・プライベートアドレス・リンクローカル・クラウドメタデータ宛先をブロックします。OAuth の issuer・authorization・registration・token・redirect の各エンドポイントも個別に検証します。接続中に DNS が変更された場合は、再度チェックが行われます。
カスタム MCP は MCP 専用です。ツールが見つからない場合やランタイムエラーが発生した場合は、明確なエラーが返されます。Minara はカスタムアクションを REST にルーティングしません。
x402 を使う有料 MCP
MCP サーバーは MCP JSON-RPC エラーで x402 チャレンジを返せます。また、直接接続したリモート HTTP または SSE ツールは 402 Payment Required を返すこともあります。対応する x402 exact USDC チャレンジでは、Minara が元の MCP リクエストに結び付け、加盟店、金額、資産、ネットワークを表示し、管理ウォレットで証明を作成して同じ呼び出しを一度だけ再試行します。
有料サーバーも通常の MCP と同じ方法で追加します。秘密鍵、支払い署名、取引証明を URL、ヘッダー、JSON、OAuth 欄に保存しないでください。MCP JSON-RPC 形式はローカル stdio を含む MCP transport で利用できます。HTTP header 支払いは直接リモート接続だけに適用され、ホスト型 Broker は PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE をそのまま転送する必要があります。x402 支払いを参照してください。