コンテンツにスキップ
mofcloud

MCP と OAuth

最終更新日:

MOF は MCP サーバーとして動作します。有効にすると、Claude Desktop、Cursor、Dify などの AI クライアントから、各ユーザーが閲覧を許可されたコストデータを照会できます。アクセスは読み取り専用です。

MCP を有効にする

管理者

  1. Admin → 設定 → MCP アクセス を開きます。
  2. 「MCP 接続を許可」をオンにします。
  3. 「接続を確認」をクリックします。MCP サービスが「接続済み」と表示されれば正常です。

MCP コンテナはデプロイテンプレートに含まれており、追加のインストールは不要です。確認に失敗した場合は、mof-mcp コンテナが実行中で、MOF と同じバージョンであることを確認してください。

OAuth を設定する

管理者 · Claude Desktop で必要

OAuth を設定すると、ユーザーは AI クライアントにアドレスを 1 つ貼り付け、MOF アカウントでログインするだけで接続できます。設定しない場合はトークンを手動で作成する必要があり、Claude Desktop ではトークンを使えません。

  1. MOF を公開 HTTPS で提供します。Claude は自社のサーバーから接続するため、アドレスはインターネットから到達可能である必要があります。
  2. mof サービスに 2 つの変数を追加し、再作成します:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. Admin → 設定 → MCP アクセス で再度「接続を確認」をクリックします。OAuth ログインが「設定済み」と表示されれば正常です。

MOF_PUBLIC_URL はユーザーが開くアドレスで、パスは含めません。シークレットは 32 文字以上で、すべての MOF サーバーで同じ値にする必要があります。「設定済み」は両方が設定されていることを示すだけで、公開コールバックが機能するかは Claude からの初回ログインで確認できます。 環境変数

Claude Desktop を接続する

すべてのユーザー

  1. MOF で 設定 → MCP 接続 を開き、サーバー URL をコピーします。
  2. Claude Desktop で Settings → Connectors → Add custom connector を開きます。名前(例:MOF)を入力し、アドレスを貼り付けます。
  3. Connect をクリックし、ブラウザで MOF アカウントにログインして承認します。
  4. Claude に質問します。例:「先月のクラウド別の支出はいくら?」
OAuth 非対応のクライアント:トークンを使う

設定 → MCP 接続 → 手動トークン で名前を入力し、「トークンを作成」をクリックします。トークンは一度しか表示されないため、すぐにコピーしてください。有効期間は 90 日です。リクエストヘッダーで送信します:

Header
Authorization: Bearer YOUR_TOKEN

アクセスを取り消す

ユーザーは 設定 → MCP 接続 の「接続済みアプリ」と「マイトークン」で、自分のアプリとトークンを取り消せます。Admin で「MCP 接続を許可」をオフにすると、すべての接続が即座に切断されます。