メインコンテンツまでスキップ

カスタム MCP サーバー

Rephlo のカタログにある Connectors に加えて、自分で運用する(または信頼できる第三者が運用する)カスタム MCP サーバーを接続できます。これは、すでに MCP サーバーとそのアクセス用トークンを持っている上級ユーザー向けの機能です。

カスタムサーバーはデスクトップアプリ設定 → Connectors → Add custom connector から追加します。Web UI での対応はなく、すべてお使いのマシン上でローカルに処理されます。

始める前に

以下が必要です。

  • 接続可能な MCP サーバー(そのコマンド、または URL)。
  • 認証が必要な場合は、そのサーバー用のベアラートークン

現在の認証方式はベアラートークンのみです。 カスタムサーバーは現在、単一の事前共有ベアラートークンでのみ認証します。トークンを貼り付けると、Rephlo はリクエストごとにそれを送信します。(Notion のように)ブラウザでサインインする OAuth ベースのカスタムサーバーはまだ対応しておらず、今後のリリースで追加される予定です。

カスタムサーバーの追加

  1. 設定 → Connectors を開き、Add custom connector をクリックします。
  2. サーバーに名前を付けて、後から識別できるようにします。
  3. トランスポート(Rephlo がサーバーと通信する方法)を選択します。
    • Streamable HTTP — Rephlo がネットワーク経由でサーバーの URL に接続します。
    • Stdio — Rephlo がローカルの実行可能ファイルを起動し、お使いのマシン上で直接通信します。
  4. トランスポートごとの設定項目を入力します(下の表を参照)。
  5. サーバーのベアラートークンを貼り付けます。
  6. 保存します。Rephlo が接続し、サーバーが提供するツールを問い合わせ、そのサーバーのツールがチャットで使用可能になります。

Add Custom Connector パネル — トランスポート(Streamable HTTP と Stdio)、設定項目、ベアラートークン欄

Add custom connector パネル。トランスポートの選択とベアラートークン欄が表示されています。

トランスポート設定

トランスポート必須任意
Streamable HTTPサーバー URL認証用のベアラートークン
Stdio起動する実行可能ファイルのパス引数

Rephlo 自身の Connectors カタログでは、一部のサーバーを SHA-256 バイナリハッシュに固定してさらなる検証を行っていますが、これは Rephlo 側で管理されるものであり、独自のカスタムコネクタを追加する際に自分で設定する項目ではありません。

データの保存場所

  • カスタムサーバーとそのベアラートークンはお使いのデバイス上に暗号化された状態で保存されます。Rephlo のバックエンドには送信されません。
  • カスタムサーバーへのツール呼び出しはデスクトップから直接サーバーへ実行されます — Rephlo のクラウドを経由しません。
  • 他のすべての Connectors と同様に、ツールの結果はセッション中メモリ上に保持され、ローカルの監査ログにはツール名・実行時間・ステータスのみが記録されます — 引数や内容は記録されません。

トラブルシューティング

サーバーが接続を拒否する(401 / unauthorized)。 ベアラートークンが誤っているか、ローテーションされています。サーバーを削除し、正しいトークンで追加し直してください。

接続がタイムアウトする。 サーバー URL に到達可能か、サーバーが十分な速さで応答しているかを確認してください — ツール呼び出しには固定の時間制限があります。サーバーの応答が単に遅い場合は、そのパフォーマンスや可用性を見直してください。

ツールが表示されない、またはツール呼び出しの解析に失敗する。 サーバーは有効な MCP を話し、Rephlo が接続した際にツールを宣言する必要があります。サーバーが正しい形式の MCP ツール定義とレスポンスを返しているか確認してください。

関連項目