Zum Inhalt springen

API-Keys und OAuth

Erstelle Workspace-gebundene API-Keys oder autorisiere einen kompatiblen Client mit OAuth.

API-Key

Öffne Getting Started, wähle den richtigen Workspace und erstelle einen benannten API-Key. Kopiere das Secret, solange es angezeigt wird: Die Liste zeigt später nur noch einen Präfix. Speichere es in der Secret-Konfiguration deiner Anwendung.

bash
curl https://www.leadbase.io/api/v1/operations/tools.list \  -H "x-api-key: $LEADBASE_API_KEY" \  -H 'Content-Type: application/json' \  -d '{"query":"search"}'

Diese Anfrage entdeckt Tools; sie führt keine kostenpflichtige Recherche aus. Die API akzeptiert einen Leadbase-Key auch als Authorization: Bearer <key>. Lege Keys niemals in Browsercode, URLs, öffentlichen Repositories oder mit anderen geteilten Prompts ab.

Ein Key gehört zum Workspace, der bei seiner Erstellung ausgewählt war. Ein späterer Workspace-Wechsel in der App verschiebt den Key nicht. Die Mitgliedschaft wird bei Anfragen erneut geprüft. Widerrufe ungenutzte oder offengelegte Keys in Getting Started und hinterlege einen Ersatz in deiner Integration.

OAuth

Nutze bei kompatiblen MCP-Clients bevorzugt deren native OAuth-Verbindung. Die MCP-Ressource lautet https://www.leadbase.io/api/mcp, die HTTP-API-Ressource https://www.leadbase.io/api. OAuth-Tokens sind an ihre Zielressource gebunden; ein Token für eine Ressource lässt sich nicht einfach für die andere verwenden.

Ressourcenmetadaten stehen unter /.well-known/oauth-protected-resource/api und /.well-known/oauth-protected-resource/api/mcp. mcp:read erlaubt Lesezugriffe; mcp:write erlaubt autorisierte Änderungen und kostenpflichtige Operationen. Jede Anfrage prüft weiterhin Mitgliedschaft und geltende Regeln.

Rate Limits

API-Keys erlauben aktuell 600 Anfragen pro 60 Sekunden je Key. Das ist ein Request-Limit, keine Zusage für 600 gleichzeitige Rechercheaufträge. Zulassung der Workflows, verfügbare Credits und einzelne Tools können weitere Grenzen setzen. Reduziere bei 429 die Anfragerate, statt mehr Keys oder doppelte Aufträge anzulegen.