API
L'API di gestione per tutta la tua istanza
Tutto ciò che fa la dashboard, come REST. Crea connettori, genera tool, attiva il code mode, genera chiavi ed esegui File Search — da uno script, un job CI o un agente.
# 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
Autenticazione
Due realm raggiungono l'API, ed entrambi rispettano il tuo ruolo. Scegli quello adatto al chiamante.
Sessione (JWT)
Utenti autenticati nella dashboard. Niente da configurare — la sessione viaggia nel browser.
Chiave di gestione
Per script e agenti. Genera una chiave con scope nelle Impostazioni o con `amcp login --browser`, poi inviala come Bearer token.
scope — Una chiave porta uno scope — management-read o management-admin — e la sua potenza effettiva è il minore tra lo scope della chiave e il ruolo del proprietario. Le chiavi per gli agenti sono read-only per impostazione predefinita.
Cosa puoi chiamare
Oltre 200 operazioni, raggruppate per risorsa. Sfoglia lo schema completo e sempre aggiornato nel riferimento interattivo.
Connectors
/api/connectorsCrea connettori e importa tool da OpenAPI, WSDL, GraphQL, Postman, cURL o HAR — oppure scoprili da un server MCP.
Tools
/api/connectors/:id/toolsElenca, crea, aggiorna ed elimina i tool esposti da un connettore, con i loro schemi di input.
MCP servers
/api/mcp-serversCrea server, assegna tool e ruoli e commuta il code mode tra off, tools e inline.
Adapters
/api/adaptersImporta dal catalogo integrato di connettori pronti all'uso tramite slug.
API keys
/api/mcp-keysGenera, elenca e revoca chiavi MCP e con scope di gestione — self-service, legate al tuo account.
File Search
/api/file-searchGestisci spazi e cartelle ricercabili perché gli agenti recuperino dai tuoi documenti.
Convenzioni
Base URL
cloud.anythingmcp.com su Cloud, o il tuo host in self-hosting. La CLI la risolve per te.
Header di auth
Authorization: Bearer <key>. Lo stesso guard accetta un JWT di sessione.
Formato
JSON in ingresso, JSON in uscita. Invia un body con --data (CLI) o Content-Type: application/json (HTTP).
Scoping
Ogni query è legata alla tua organizzazione; una chiave non raggiunge mai i dati di un altro tenant.
Rate limit
300 richieste al minuto per chiave per impostazione predefinita, regolabile dall'operatore. Un 429 significa rallenta.
Errori
Codici di stato HTTP standard; 401 auth errata o mancante, 403 scope o ruolo troppo basso, 404 non trovato.
Costruisci sull'API
Prendi una chiave, apri il riferimento interattivo e piloti la tua istanza da cima a fondo.