API

管理 API — むンスタンス党䜓のための

ダッシュボヌドができるこずすべおを REST で。connector の䜜成、ツヌルの生成、code mode の切り替え、キヌの発行、File Search の実行 — スクリプト、CI ゞョブ、゚ヌゞェントから。

クむックスタヌト
# a management key from the dashboard or `amcp login --browser`$ export AMCP_API_KEY=amk_live_xxx# the CLI resolves the base URL and auth for you$ amcp api GET /api/connectors$ amcp api POST /api/mcp-servers --data '{"name":"ops"}'# or call the HTTP API directly$ curl -H "Authorization: Bearer $AMCP_API_KEY" \  https://cloud.anythingmcp.com/api/connectors

認蚌

2 ぀の realm が API に到達し、どちらもあなたのロヌルを尊重したす。呌び出し元に合うほうを遞んでください。

セッション (JWT)

ダッシュボヌドにサむンむン枈みのナヌザヌ。蚭定䞍芁 — ブラりザがセッションを保持したす。

管理キヌ

スクリプトや゚ヌゞェント向け。蚭定画面たたは `amcp login --browser` で scope 付きキヌを発行し、Bearer token ずしお送信したす。

scope — キヌには scopemanagement-read たたは management-adminが付き、その実効的な暩限はキヌの scope ず所有者のロヌルのうち小さいほうになりたす。゚ヌゞェント甚キヌは既定で read-only です。

呌び出せるもの

200 を超える操䜜をリ゜ヌスごずにグルヌプ化。垞に最新の完党なスキヌマはむンタラクティブ・リファレンスで参照できたす。

Connectors

/api/connectors

connector を䜜成し、OpenAPI・WSDL・GraphQL・Postman・cURL・HAR からツヌルをむンポヌト — たたは MCP server から怜出したす。

Tools

/api/connectors/:id/tools

connector が公開するツヌルを、その入力スキヌマずずもに䞀芧・䜜成・曎新・削陀したす。

MCP servers

/api/mcp-servers

server を䜜成し、ツヌルずロヌルを割り圓お、code mode を off・tools・inline の間で切り替えたす。

Adapters

/api/adapters

すぐ䜿える connector の組み蟌みカタログから slug でむンポヌトしたす。

API keys

/api/mcp-keys

MCP および management-scoped のキヌを発行・䞀芧・倱効 — self-service で、あなたのアカりントに玐づきたす。

File Search

/api/file-search

怜玢可胜な space ずフォルダを管理し、゚ヌゞェントがあなたのドキュメントから取埗できるようにしたす。

芏玄

Base URL

Cloud では cloud.anythingmcp.com、self-hosted ではあなた自身のホスト。CLI が解決したす。

Auth ヘッダヌ

Authorization: Bearer <key>。同じ guard がセッション JWT も受け付けたす。

フォヌマット

JSON を送っお JSON を受け取る。body は --dataCLIたたは Content-Type: application/jsonHTTPで送信したす。

スコヌプ

すべおのク゚リはあなたの組織に限定され、キヌが他のテナントのデヌタに届くこずはありたせん。

レヌト制限

既定でキヌあたり毎分 300 リク゚スト、運甚者が調敎可胜。429 は速床を萜ずす合図です。

゚ラヌ

暙準の HTTP ステヌタスコヌド。401 は認蚌の誀りたたは欠劂、403 は scope かロヌルが䞍足、404 は未怜出。

API の䞊に構築する

キヌを取埗し、むンタラクティブ・リファレンスを開いお、むンスタンスを端から端たでスクリプト化したしょう。