Skip to main content

接続URL

この接続URLをMCP対応のAIクライアントに登録するだけで利用を開始できます。 複数のUTAGEアカウントを接続する場合は、URLの末尾に識別子を付けて使い分けます(後述の「複数アカウントの接続」を参照)。

claude.ai(ブラウザ版)

ブラウザでclaude.aiにアクセスし、カスタムコネクターとして追加します。
  1. 画面左下の カスタマイズ を開く
  2. コネクター セクションで + をクリック
  3. カスタムコネクターを追加 を選択
  4. 接続URLを入力して 追加
  5. 初回利用時にUTAGEのログイン・認可画面が表示される
  6. ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了
チャット画面の + ボタン > コネクター から、会話ごとにオン/オフを切り替えできます。
Claudeのプランによってカスタムコネクターの追加数に制限がある場合があります。詳しくはClaudeのヘルプをご確認ください。

Claude Desktop

  1. 設定 を開く
  2. サイドバーの コネクター を開く
  3. 追加 から カスタムコネクターを追加 を選択
  4. 接続URLを入力して追加
  5. 初回利用時にブラウザが開き、UTAGEのログイン・認可画面が表示される
  6. ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了
リモートMCPサーバーは設定ファイル(claude_desktop_config.json)では追加できません。必ず設定画面のコネクターから追加してください。

Claude Code

プロジェクトの .mcp.json にURLを設定します。
初回実行時にブラウザが開き、認証が行われます(手順は後述の「認証」と同じです)。

ChatGPT(デスクトップアプリ)

ChatGPTのデスクトップアプリにMCPサーバー(リモートMCP)として追加します。
  1. 設定 > プラグイン > MCP を開く
  2. 追加 > MCPサーバーを追加 を選択
  3. 接続URL(https://api.utage-system.com/mcp)を入力して追加
  4. 初回接続時にUTAGEのログイン・認可画面が表示される
  5. ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了

Cursor

Cursorでは、~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json)に接続URLとAPIキーを設定します。ほかのクライアントで使うOAuth自動認証の代わりに、認証ページの手順で発行したAPIキーを headers に指定します。
YOUR_API_KEY は、UTAGE管理画面の「API設定」画面で発行したAPIキーに置き換えてください。

認証

接続時にOAuth 2.1で自動認証されます。
  1. AIクライアントがMCPサーバーに接続
  2. ブラウザが開き、UTAGEのログイン画面が表示される。メールアドレスとパスワードでログインする
  3. 二段階認証を有効にしているアカウントでは「二段階認証」画面が表示される。認証アプリに表示されている6桁の認証コードを入力する。認証アプリが使えないときは「リカバリーコードを使う」を開き、保存しておいたリカバリーコード(10桁-10桁)を入力する(各コードは1回だけ使える)
  4. 「アクセス許可の確認」画面でAPI利用ポリシーに同意し、「許可する」をクリック
  5. 接続完了
接続時に発行されたAPIキー(MCP接続キー)は、UTAGE管理画面の「API設定」画面で確認・管理できます。

オペレーターでログインする場合

ログイン画面の「オペレーターの方はこちら」を開き、オペレーターのログインURL(https://utage-system.com/operator/xxxxxxxx/login の形式)を入力してから、オペレーターのメールアドレスとパスワードでログインします。 オペレーター権限の「API設定」が「利用可」でないオペレーターは、ログイン後の認可画面で「APIへのアクセス権限がありません。」になり接続できません。契約者がオペレーター管理の権限設定で「API設定」を「利用可」にしてから接続してください。 契約者が二段階認証を必須にしている場合、二段階認証を未設定のオペレーターはMCPからログインできず、「二段階認証の設定が必要です」のエラーになります。先にUTAGE管理画面にログインし、「アカウント情報 > 二段階認証」で設定してから接続してください。

ログインできないとき

  • ログインに続けて失敗すると、一時的にロックされます。画面に「ログインに続けて失敗しています」と待ち時間が表示されるので、その時間が経ってから再試行してください
  • 利用停止中のアカウントはMCPにログインできません。発行済みのMCP接続キーも、利用停止日の当日0:00から使えなくなります

MCP接続キーの上限

1つのアカウントで発行できるMCP接続キーの数には上限があります。上限に達していると、認可画面に「MCP接続キーの発行上限に達しています。管理画面のAPI設定から不要なキーを削除してください。」と表示され、接続できません。UTAGE管理画面の「API設定」画面で不要なキーを削除してから、再度接続してください。 同じクライアント(同じ接続URL)で再度認証した場合は、そのクライアント用に発行されていた以前のMCP接続キーが無効化され、新しいキーが発行されます。

複数アカウントの接続

1人で複数のUTAGEアカウントを同時にMCP連携する場合は、接続URLの末尾に任意の識別子を付け、アカウントごとに別々のURLとして登録します。
末尾の識別子には半角小文字の英数字とハイフン(a-z 0-9 -)が使用できます。 MCPクライアントは接続URLごとに認証情報を保持するため、すべて同じ /mcp で登録すると1アカウントしか接続できません。アカウントごとにURLの末尾を変えることで、それぞれが独立した接続として扱われ、複数アカウントを同時に操作できます。各URLの初回認証時に、操作したいアカウントでログインしてください(認可画面の「別のアカウントでログイン」から切り替えられます)。
末尾の識別子は接続を区別するためのラベルで、特定のアカウントを指すものではありません。どのアカウントに接続されるかは、そのURLの認証時にログインしたアカウントによって決まります。

動作確認

接続後、AIに「UTAGEのファネル一覧を取得して」と指示して、ツールが呼び出されることを確認してください。