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

AI クライアント接続ガイド(MCP)

MCP 対応の AI クライアントから、AGENTIC STAR の MCP につなぐ手順です。チャットの組のツールでは Agent に仕事を頼み、プロジェクトの組のツールではプロジェクトを作る・動かす・確認依頼を片付けるなどができます。ツールとスコープの詳しい仕様は MCP API リファレンス を参照してください。

用意するもの​

  • 使う AI クライアント(Claude Code・Codex・Cursor・VS Code・Claude)
  • 人がつなぐとき: Console で作ったアプリケーション(Client ID)
  • システム連携でつなぐとき: Console で作ったシステム連携と、その API キー

プラグインで入れる(おすすめ)​

Claude Code・Codex・Claude には、AGENTIC STAR のプラグインを入れられます。入れた後に「AGENTIC STAR につないで」と頼むと、つなぎ方を案内します。

入っているもの役割
agenticstar-connectAGENTIC STAR の MCP につなぐ手順を案内する
agenticstar-projectsプロジェクトを作る・失敗を調べて直す・確認依頼を片付ける・結果を読む
  • MCP の接続設定は入っていません。Client ID や API キーは、案内に沿って設定します
  • マーケットプレイス版とは別のプラグインです。SaaS版ではこのページのプラグインを使ってください
  • 今の版: 3.4.0

プラグインをダウンロード(agenticstar.zip)

zip を展開したフォルダで、次を実行します(Claude Code 2.1.292 以降)。

curl
claude plugin install agenticstar --marketplace ./agenticstar

つなぎ方を選ぶ​

使う人つなぎ方Console で用意するもの
人(自分のアカウントで使う)クライアントでログインするアプリケーション(Client ID)
仕組み(システム連携)固定の API キーを Authorization: Bearer に書くシステム連携の API キー

MCP のエンドポイントは次のとおりです。使うツールの組を toolsets で選びます(ツールの組)。

https://api.fd.agenticstar.tm.softbank.jp/api/v1/mcp?toolsets=chat,project
設定の例について

このページの設定は、参考のための例です。設定の方法は、クライアントの版によって変わることがあります。最新の方法は、各クライアントの文書を確認してください(Claude Code・Codex・Cursor・VS Code・Claude)。ほかの MCP クライアントでは、エンドポイント・Client ID・Redirect URI を、そのクライアントの文書に沿って設定してください。

人がつなぐ​

1. Console でアプリケーションを作る​

Console ガイド — アプリケーションの作成手順 に沿って作ります。

  • アプリケーションの種類: 「モバイル / ネイティブ」を選びます(Client Secret を持たず、PKCE でログインします)
  • Redirect URI: 使うクライアントの戻り先を登録します(下の表)。使うものを全部登録してください
  • スコープ: mcp:connect と、使うツールのスコープを選びます。ツールごとのスコープは MCP API リファレンス — 提供ツール にあります(例: チャットの組を使うなら chat:exec、プロジェクトを読むなら project:read)
クライアント登録する Redirect URI
Claude Codehttp://localhost:<ポート>/callback(--callback-port に指定するポート)
Codexcallback_url に書く値(例: http://localhost:<ポート>/callback)
Cursor(デスクトップ版)http://localhost:8787/callback
VS Codehttp://127.0.0.1/ と https://vscode.dev/redirect
Claudehttps://claude.ai/api/mcp/auth_callback
  • 戻り先が http://127.0.0.1・http://[::1]・http://localhost のときは、ポートを問いません。ポートを除いて登録すると(例: http://localhost/callback)、クライアントがどのポートを使ってもログインできます。ポートを付けて登録したときは、そのポートだけです
  • 戻り先を自分で決められるクライアント(Codex の callback_url など)では、localhost より 127.0.0.1 をおすすめします
  • 前に VS Code 用に http://127.0.0.1:33418/ を登録したクライアントは、http://127.0.0.1/ を足してください

2. クライアントを設定してログインする​

<client_id> には、作ったアプリケーションの Client ID を入れます。

curl
claude mcp add --scope user --transport http \
--client-id <client_id> --callback-port <ポート> \
agenticstar 'https://api.fd.agenticstar.tm.softbank.jp/api/v1/mcp?toolsets=chat,project'

Claude Code の中で /mcp を開いて agenticstar の認証を選ぶか、claude mcp login agenticstar を実行すると、ブラウザでログインの画面が開きます。

システム連携でつなぐ​

  1. Console ガイド — システム連携の作成手順 に沿って作ります。スコープは mcp:connect と、使う操作に合わせて project:read・project:run を選び、プロジェクト制限 を設定します
  2. システム連携の詳細の画面で API キーを発行します(Console ガイド — API キー)
  3. クライアントに Authorization: Bearer <API キー> を設定します。トークンを取り直す必要はありません
curl
claude mcp add --scope user --transport http agenticstar-system \
'https://api.fd.agenticstar.tm.softbank.jp/api/v1/mcp?toolsets=project' \
--header "Authorization: Bearer <API キー>"

システム連携で使えるのは、プロジェクトの組の 5 つの操作(project_read の list・run_read の get・project_run の start_run・fire_trigger・cancel_run)と、チャットの組の list_personas です(list_personas を使うときは toolsets=chat,project)。扱えるのは、プロジェクト制限の範囲のプロジェクトだけです。Claude では、システム連携のつなぎ方はありません。

安全に使う​

  • 書き込む操作: プロジェクトを作る・変える・消す、確認依頼を決めるなどの操作を AI に任せるときは、クライアントの許可の仕組みで、実行の前に確かめられるようにしてください(Claude Code は、確認依頼を決める前に毎回許可を求めます。Claude は、ツールごとに許可を設定できます。ほかのクライアントは、そのクライアントの文書を確認してください)
  • 読むだけで使う: 読むだけで使うときは、スコープを mcp:connect と project:read だけにしたアプリケーションを作ってください
  • API キー: API キーは、Client Secret と同じく秘密の値として扱ってください。チャットや文書に貼らないでください
  • 資格情報が漏れたとき: 人がつなぐときは、Console でアプリケーションを削除してください。システム連携は、API キーを削除するか、システム連携を無効化してください。反映まで最大 1 分ほどかかります(Console ガイド — 資格情報が漏れたとき)

つながらないとき​

  • ツールの組: toolsets を指定しないと、チャットの組だけになります。プロジェクトの組を使うときは project を指定してください
  • Redirect URI の食い違い: ログインの画面で Redirect URI のエラーが出たときは、クライアントの戻り先と、Console に登録した Redirect URI が合っているかを確かめてください(Claude Code・Codex はポート)
  • スコープの不足: スコープが足りないツールを呼ぶと、ツールのエラーで、要るスコープと次にやることが返ります。人のアプリケーションでは、Console でスコープを足してからログインし直してください
  • システム連携の範囲: システム連携で扱えるのは、プロジェクト制限の範囲のプロジェクトだけです
  • システム連携で断られる: This endpoint is not available to client credentials(403)は、システム連携では使えない操作を呼んだときの答えです。その操作は、人のつなぎ方でつないで使ってください
  • 前段の仕組み(WAF): 入力の内容によっては、前段の仕組みでリクエストが止められます。このときは HTTP の 403 で、本文の JSON の error.code が waf_blocked です。参照番号があるときは error.reference に入ります
  • ツールが変わったとき: AGENTIC STAR の更新でツールが変わったときは、つなぎ直してください(Claude Code は /mcp、Claude はコネクタのメニューからツールの一覧を更新します)

関連ドキュメント​