API

Die Management-API für deine ganze Instanz

Alles, was das Dashboard kann, als REST. Connectors anlegen, Tools erzeugen, Code-Mode umschalten, Schlüssel erstellen und File Search ausführen — aus einem Skript, einem CI-Job oder einem Agenten.

Schnellstart
# 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

Authentifizierung

Zwei Realms erreichen die API, und beide achten auf deine Rolle. Nimm den, der zum Aufrufer passt.

Session (JWT)

Angemeldete Nutzer im Dashboard. Nichts zu konfigurieren — der Browser trägt die Session.

Management-Schlüssel

Für Skripte und Agenten. Einen Scoped Key in den Einstellungen oder mit `amcp login --browser` erstellen und als Bearer-Token senden.

scope — Ein Schlüssel trägt einen Scope — management-read oder management-admin — und seine effektive Macht ist das Minimum aus Schlüssel-Scope und Rolle des Besitzers. Agenten-Schlüssel sind standardmäßig read-only.

Was du aufrufen kannst

Über 200 Operationen, nach Ressource gruppiert. Das vollständige, stets aktuelle Schema findest du in der interaktiven Referenz.

Connectors

/api/connectors

Connectors anlegen und Tools aus OpenAPI, WSDL, GraphQL, Postman, cURL oder HAR importieren — oder aus einem MCP-Server entdecken.

Tools

/api/connectors/:id/tools

Die Tools eines Connectors samt Input-Schema auflisten, anlegen, ändern und löschen.

MCP servers

/api/mcp-servers

Server anlegen, Tools und Rollen zuweisen und Code-Mode zwischen off, tools und inline umschalten.

Adapters

/api/adapters

Aus dem eingebauten Katalog fertiger Connectors per Slug importieren.

API keys

/api/mcp-keys

MCP- und Management-Scoped-Schlüssel erstellen, auflisten und widerrufen — self-service, an dein Konto gebunden.

File Search

/api/file-search

Durchsuchbare Spaces und Ordner verwalten, damit Agenten aus deinen Dokumenten abrufen.

Konventionen

Basis-URL

cloud.anythingmcp.com in der Cloud, oder dein eigener Host self-hosted. Die CLI löst sie auf.

Auth-Header

Authorization: Bearer <key>. Derselbe Guard akzeptiert ein Session-JWT.

Format

JSON rein, JSON raus. Body mit --data (CLI) oder Content-Type: application/json (HTTP) senden.

Scoping

Jede Query ist an deine Organisation gebunden; ein Schlüssel erreicht nie die Daten eines anderen Tenants.

Rate-Limit

Standardmäßig 300 Anfragen pro Minute und Schlüssel, vom Betreiber einstellbar. Ein 429 heißt: zurückfahren.

Fehler

Standard-HTTP-Statuscodes; 401 falsche oder fehlende Auth, 403 Scope oder Rolle zu niedrig, 404 nicht gefunden.

Bau auf die API

Schlüssel holen, interaktive Referenz öffnen und deine Instanz durchgängig skripten.