Dokumentation

Schnellstart

Alles Folgende passiert in der Web-Konsole: registrieren, auf „Neues Projekt“ klicken und den drei Schritten folgen. Kein API-Key nötig.

1. Importieren Sie Ihre API

   Bringen Sie eine OpenAPI-Spezifikations-URL, einen curl-Befehl oder eine Postman-Collection mit — Invokera wandelt sie in typisierte MCP-Tools um.

2. Domainbesitz bestätigen

   Weisen Sie mit einem DNS-TXT-Eintrag oder einer Well-known-Datei nach, dass Ihnen die Domain der API gehört.

3. Veröffentlichen

   Nach dem Go-live erhält Ihr Projekt einen MCP-Endpunkt, einen REST-Endpunkt und eine KI-lesbare Landingpage.

So sieht Erfolg aus

Vier Momente aus einem echten Projekt — zum Abgleichen, dass Sie auf Kurs sind. Sehen Sie das Ergebnis live: das Demo-Projekt Invokera Status.

Drei Wege zum Import

OpenAPI (URL)

Fügen Sie eine öffentliche OpenAPI/Swagger-Spezifikations-URL im OpenAPI-Tab der Konsole ein — der schnellste und vollständigste Weg.

curl

Fügen Sie einen funktionierenden curl-Befehl in den curl-Tab der Konsole ein — Invokera leitet daraus ein typisiertes Tool ab. Zum Beispiel:

curl https://api.example.com/v1/users -H "Authorization: Bearer KEY"

Postman

Exportieren Sie Ihre Collection in Postman als Collection v2.1 JSON und fügen Sie das JSON in den Postman-Tab der Konsole ein.

Fehlerbehebung bei der Domain-Verifizierung

Die Verifizierung prüft einen TXT-Eintrag unter _invokera-challenge.<ihre-domain> (oder eine Datei unter /.well-known/invokera-challenge.txt). Eine Challenge ist 72 Stunden gültig und erlaubt bis zu 30 Prüfungen. Häufige Fehlerquellen:

Über MCP verbinden

Claude Code

Der schnellste Weg zur Verbindung — führen Sie einen Befehl im Terminal aus:

claude mcp add --transport http your-project https://invokera.com/r/your-project --header "Authorization: Bearer inv_YOUR_TOKEN"

Erfolgskontrolle: Stellen Sie im Chat eine Frage — sehen Sie Ihre Tool-Namen, ist die Verbindung aktiv.

Claude Desktop

Fügen Sie Ihr Projekt mit dem streamable-HTTP-Endpunkt und Ihrem Endpunkt-Token zur claude_desktop_config.json hinzu:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Bearbeiten Sie die Datei für Ihr Betriebssystem und starten Sie Claude Desktop danach neu, damit die Änderung wirksam wird.

Erfolgskontrolle: Stellen Sie im Chat eine Frage — sehen Sie Ihre Tool-Namen, ist die Verbindung aktiv.

Cursor

Erstellen Sie .cursor/mcp.json im Projektstammverzeichnis mit derselben JSON-Form:

{
  "mcpServers": {
    "your-project": {
      "type": "http",
      "url": "https://invokera.com/r/your-project",
      "headers": { "Authorization": "Bearer inv_YOUR_TOKEN" }
    }
  }
}

Erfolgskontrolle: Stellen Sie im Chat eine Frage — sehen Sie Ihre Tool-Namen, ist die Verbindung aktiv.

REST

Kein MCP-Client? Jedes Projekt stellt zusätzlich einen selbstbeschreibenden REST-Endpunkt bereit:

curl https://invokera.com/v1/your-project/tools -H "Authorization: Bearer inv_YOUR_TOKEN"

Automatisierung / CI

Plattform-API-Keys (ik_) zur skriptgesteuerten Projektverwaltung sind noch nicht zur Selbstbedienung verfügbar. Für Automatisierung oder CI-Integration kontaktieren Sie uns — wir schalten einen Key für Ihr Konto frei. Ein Aufruf sieht so aus:

curl -X POST https://invokera.com/api/v1/projects -H "Authorization: Bearer ik_YOUR_API_KEY" -H "Content-Type: application/json" -d '{"specUrl":"https://api.example.com/openapi.json"}'

FAQ

Mein Aufruf schlägt mit einem Fehlercode fehl — was bedeutet er?

MCP-Fehler tragen einen JSON-RPC-Code und einen HTTP-Status. Die häufigsten:

Die Domain-Verifizierung schlägt immer wieder fehl — was sollte ich prüfen?

DNS-TXT-Einträge brauchen mitunter Zeit, um sich zu verbreiten — warten Sie ein paar Minuten und prüfen Sie erneut. Verifiziert wird die registrierbare Domain (eTLD+1), nicht die Subdomain. Liegt Ihre API auf der Subdomain einer Hosting-Plattform, verwenden Sie stattdessen die .well-known-Dateimethode.

Was ist der Unterschied zwischen inv_- und ik_-Tokens?

inv_-Endpunkt-Tokens erlauben Aufrufern nur, Ihre veröffentlichten Tools zu nutzen. ik_-Plattform-API-Schlüssel verwalten Ihr Konto und Ihre Projekte — geben Sie sie niemals an Agenten weiter.

Wie rotiere ich einen Endpunkt-Token?

Öffnen Sie das Projekt in der Konsole und verwenden Sie „Token rotieren“. Der alte Token funktioniert sofort nicht mehr — aktualisieren Sie Ihre Agenten direkt danach.

Ich habe meinen Aufruf-Token verloren — wie bekomme ich ihn zurück?

Tokens werden nie erneut angezeigt. Nutzen Sie auf der Projektseite „Token rotieren": Sie erhalten sofort einen neuen Token, der alte wird ungültig — aktualisieren Sie alle Clients, die ihn verwendet haben.

Claude ist verbunden, sieht aber keine Tools — woran liegt das?

Meist eine von drei Ursachen: Das Projekt hat keine aktivierten Tools (in der Konsole aktivieren); der Client wurde nach der Konfigurationsänderung nicht vollständig neu gestartet (Claude Desktop komplett beenden und neu öffnen); Endpunkt-URL oder Token sind falsch — schließen Sie Serverprobleme mit dem Testaufruf in der Konsole aus.