接続URL
claude.ai(ブラウザ版)
ブラウザでclaude.aiにアクセスし、カスタムコネクターとして追加します。- 画面左下の カスタマイズ を開く
- コネクター セクションで + をクリック
- カスタムコネクターを追加 を選択
- 接続URLを入力して 追加
- 初回利用時にUTAGEのログイン・認可画面が表示される
- ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了
Claudeのプランによってカスタムコネクターの追加数に制限がある場合があります。詳しくはClaudeのヘルプをご確認ください。
Claude Desktop
- 設定 を開く
- サイドバーの コネクター を開く
- 追加 から カスタムコネクターを追加 を選択
- 接続URLを入力して追加
- 初回利用時にブラウザが開き、UTAGEのログイン・認可画面が表示される
- ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了
リモートMCPサーバーは設定ファイル(
claude_desktop_config.json)では追加できません。必ず設定画面のコネクターから追加してください。Claude Code
プロジェクトの.mcp.json にURLを設定します。
ChatGPT(デスクトップアプリ)
ChatGPTのデスクトップアプリにMCPサーバー(リモートMCP)として追加します。- 設定 > プラグイン > MCP を開く
- 追加 > MCPサーバーを追加 を選択
- 接続URL(
https://api.utage-system.com/mcp)を入力して追加 - 初回接続時にUTAGEのログイン・認可画面が表示される
- ログイン(二段階認証を有効にしているアカウントでは認証コードを入力)し、API利用ポリシーに同意して「許可する」をクリックで接続完了
Cursor
Cursorでは、~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json)に接続URLとAPIキーを設定します。ほかのクライアントで使うOAuth自動認証の代わりに、認証ページの手順で発行したAPIキーを headers に指定します。
YOUR_API_KEY は、UTAGE管理画面の「API設定」画面で発行したAPIキーに置き換えてください。
認証
接続時にOAuth 2.1で自動認証されます。- AIクライアントがMCPサーバーに接続
- ブラウザが開き、UTAGEのログイン画面が表示される。メールアドレスとパスワードでログインする
- 二段階認証を有効にしているアカウントでは「二段階認証」画面が表示される。認証アプリに表示されている6桁の認証コードを入力する。認証アプリが使えないときは「リカバリーコードを使う」を開き、保存しておいたリカバリーコード(10桁-10桁)を入力する(各コードは1回だけ使える)
- 「アクセス許可の確認」画面で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の認証時にログインしたアカウントによって決まります。