# API

マーケットプレイス版では、Chat API（SSE）で自社のアプリケーションから Agent を呼び出します。会話履歴・ファイル管理・成果物取得・検索・プロジェクト操作も REST API として利用できます。MCP 対応の AI クライアント（Claude Code・Codex など）からは、MCP でつなげます。A2A に対応した外のエージェントからは、A2A で登録 Agent と公開したワークフローを呼べます。

## 始め方

使い方は 2 つあります。準備する所が違います（[API 利用準備ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/setup-guide.md)）。

| 使い方      | だれが使うか                | 始め方                                                                                                                                                                                      |
| -------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| システム連携   | 会社のシステム               | 管理コンソールでサービスアカウントを作成したら、[API を呼び出す](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/quickstart/call-api.md) の手順で最初のリクエストを送ってみてください                                 |
| アプリケーション | 社員（外部ツールから、自分のアカウントで） | 管理者が外部ツールでのログインの入口を開け、認証サーバーのコンソールで外部ツールのクライアントを作成したら、[AI クライアント接続ガイド（MCP）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/ai-client-guide.md) の手順でつないでください |

## ガイド / リファレンス

- [API 利用準備ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/setup-guide.md) — 外部ツールのクライアントとサービスアカウントの作り方
- [認証ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/auth-guide.md) — トークンの取り方
- [接続方式ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/connection-guide.md) — Chat API・MCP・A2A の選び方
- [ストリーミングガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/streaming-guide.md) — SSE のライフサイクル、レスポンスオブジェクト、イベント処理
- [プロジェクト API ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/project-api-guide.md) — うまくいかなかった実行を見つけて直す流れ
- [AI クライアント接続ガイド（MCP）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/ai-client-guide.md) — Claude Code などの AI クライアントからつなぐ（プラグイン・人・システム連携）
- [ユーザー API リファレンス（会話・組織）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/user-api-reference.md)・[ユーザー API リファレンス（プロジェクト）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/user-api-reference-projects.md) — アプリケーションのトークンで呼ぶエンドポイント仕様
- [システム連携 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/api-reference.md) — システム連携のトークンで呼ぶエンドポイント仕様
- [認証 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/auth-mp-ref.md) — トークン取得の仕様
- [MCP API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/mcp-ref.md) — MCP のツールの仕様
- [A2A API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/a2a-ref.md) — A2A のエンドポイントの仕様

> **SaaS 版との違い**
>
> LLM Gateway、およびライブラリ・ライブラリの Agent・スキル・プレイブック・ペルソナ・マスターデータ（組織・職種）の管理・ユーザー管理・ログ・共有メモリの各 API は、SaaS 版の API として公開しています。チャットで使う登録 Agent の一覧（`GET /v1/marketplace-agents`）はマーケットプレイス版でも使えます。SaaS 版の仕様は [SaaS ＞ API](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api.md) を参照してください。
