Tovanix
Tovanix

MCP-Zugang

Verbinden Sie Ihr Tovanix-Konto mit einem beliebigen MCP-fähigen KI-Client. Der Endpunkt https://tovanix.com/api/mcp/rpc verwendet zustandsloses Streamable HTTP und akzeptiert nur POST.

  • Authentifizierung: Authorization: Bearer <credential> oder der Header X-MCP-Key. Zugangsschlüssel beginnen mit mcp_live_ und werden einmal angezeigt
  • Berechtigungen: Jede Funktion ist zunächst ausgeschaltet. tools/list liefert nur freigeschaltete Funktionen mit Namen aus tovanix_ und dem Funktionsnamen
  • Werkzeuge für Ausgaben und irreversible Aktionen benötigen den Einmalcode totp_code und halten Aufruf- und Tageslimits ein
  • Quell-IP-Freigabelisten, Ablaufdaten und standardmäßig 120 Aufrufe pro Minute (bis zu 600)
  • Drei Ressourcen (Funktionskatalog, Kontoübersicht, Plattformleitfaden) und drei Prompts (Kontoprüfung, Ausgabenbericht, Ablaufprüfung)
  • Fehler: 401 ungültige Zugangsdaten, 403 unzulässige Quelle oder Kontostatus, 405 keine POST-Anfrage, 413 Anfrage zu groß
  • Vor dem Erstellen müssen Sie die MCP-Zugriffsvereinbarung lesen und akzeptieren. Für Inhalte und Aktionen in Ihrem Namen sind Sie verantwortlich
  • Neben Ausgaben und irreversiblen Aktionen benötigen auch wichtige Einstellungen wie Callback-URLs, öffentliche Beiträge und öffentlicher Bucket-Zugriff einen Einmalcode. KI-Beiträge, Supportnachrichten, E-Mails und aktuelle Telegram-Abfragen unterliegen Kontolimits. Wiederholte Beiträge und Supportnachrichten werden abgelehnt; Supportnachrichten tragen den Hinweis „Über KI-Assistent gesendet“

POST /api/mcp/rpc

Drei Zugangstypen mit unterschiedlichen Aufgaben

MCP (Model Context Protocol) ermöglicht KI-Clients wie Claude, Funktionen Ihres Tovanix-Kontos als „Tools“ aufzurufen. In der Konsole erstellen Sie für jeden Client eigene MCP-Zugangsdaten und aktivieren einzeln die erlaubten Funktionen. Der Client verbindet sich damit mit dem Endpunkt und kann anschließend im Gespräch Daten abrufen und Aktionen ausführen.

MCP hat einen eigenen Endpunkt und eigene Zugangsdaten, unabhängig von der offenen API und der Konsolenanmeldung. Das Löschen von MCP-Zugangsdaten beeinflusst Ihre bestehenden API-Integrationen nicht und umgekehrt.

  • Offene API /api/v1/* — API-Schlüssel (X-API-Key / Signatur) — Von Ihnen geschriebene Programme — Wie im Schlüssel eingestellt
  • MCP /api/mcp/rpc — MCP-Zugangsdaten (Bearer) — KI-Clients — Keine — einzeln aktiviert
  • Konsole — Anmeldesitzung — Sie selbst — Alles in Ihrem Konto

Schnellstart

Jeder MCP-Client mit Unterstützung für Streamable HTTP und konfigurierbaren Anfrage-Headern kann sich verbinden. Wählen Sie unten Ihr Tool und kopieren Sie den passenden Befehl oder die Konfiguration.

Sie können Zugangsdaten auch mit einem tools/list-Aufruf per curl prüfen. Der Server ist zustandslos; ein vorheriger initialize-Aufruf ist daher nicht erforderlich.

Gespeichert wird nur ein Hash der Zugangsdaten; sie können nicht wiederhergestellt werden. Bei Verlust löschen Sie sie und erstellen neue. Bewahren Sie sie in der Client-Konfiguration auf, niemals in einem öffentlichen Repository, Screenshot oder Chat.

Endpunkt und Authentifizierung

Die Seite „MCP-Zugang“ in der Konsole zeigt den Endpunkt für Ihr Konto zum direkten Kopieren.

  • Endpunkt — Alle Anfragen gehen an diese eine URL.
  • Transport — Streamable HTTP, zustandslos: Jede Anfrage wird einzeln authentifiziert. Nur POST wird akzeptiert, und es wird keine Mcp-Session-Id ausgegeben; GET und DELETE erhalten 405.
  • Authentifizierung — Authorization: Bearer <credential>. Falls Ihr Client nur benutzerdefinierte Header zulässt, Authorization aber nicht ändern kann, verwenden Sie stattdessen X-MCP-Key: <credential>.
  • Protokollversionen — 2025-06-18 (aktuellste), 2025-03-26 und 2024-11-05, ausgehandelt anhand der Version, die der Client in initialize sendet. Nicht unterstützte Versionen fallen auf die aktuellste zurück.
  • Nachrichten — JSON-RPC 2.0 mit einem Limit von 1 MB pro Anfrageinhalt. Batch-Anfragen älterer Clients dürfen höchstens 32 Einträge enthalten.
  • Browseranfragen — Anfragen mit einem Origin-Header von anderen als den eigenen Plattform-Websites werden abgewiesen (Schutz vor DNS-Rebinding). Desktop- und Befehlszeilen-Clients senden keinen Origin-Header und sind nicht betroffen.

Zugangsdaten und Berechtigungen

Zugangsdaten beginnen mit mcp_live_ und sind 73 Zeichen lang. Jeder Zugang hat die folgenden eigenen Einstellungen, die Sie jederzeit in der Konsole ändern können. Abgelaufene oder deaktivierte Zugangsdaten werden sofort unwirksam.

Vor dem Erstellen von Zugangsdaten müssen Sie die MCP-Zugangsvereinbarung lesen und akzeptieren. Sie beschreibt die Risiken, wenn eine KI Ihr Konto bedient, und deren Verantwortlichkeit: Für Vorgänge und Verluste über MCP tragen Sie die Verantwortung. Ohne veröffentlichte Vereinbarung können keine Zugangsdaten erstellt werden. Nach einer Aktualisierung erfordern neue Zugangsdaten eine erneute Zustimmung; bestehende bleiben gültig.

Bei eingeschränkten Konten erlaubt MCP nur Lesefunktionen. Schreibzugriffe, Ausgaben und irreversible Aktionen werden mit einem Hinweis auf die Konsole abgewiesen. Ist das Konto gesperrt, erhalten alle Anfragen 403.

Tools und Benennung

Tool-Name = tovanix_ + Funktionsname, wobei Punkte durch Unterstriche ersetzt werden. Beispielsweise wird account.balance.get zum Tool tovanix_account_balance_get.

tools/list liefert nur die für diese Zugangsdaten aktivierten Funktionen. Jede Tool-Beschreibung erklärt Einsatzfälle, Parameter und wichtige Hinweise. Anhand dieser Informationen wählen KI-Clients ihre Tools aus.

Lesen: nur lesender Zugriff. Schreiben: rückgängig zu machende Änderungen, etwa das Bearbeiten eines Hinweises. Ausgeben: belastet Ihr Guthaben. Irreversibel: nicht rückgängig zu machen, etwa das Löschen eines Schlüssels oder Kündigen einer Karte. Ausgaben und irreversible Tools erfordern einen Einmalcode (siehe nächsten Abschnitt). Einige rückgängig zu machende Änderungen, die Sie dennoch unmittelbar genehmigen müssen — Callback-URL ändern, Beitrag veröffentlichen, Bucket öffentlich machen — erfordern ebenfalls einen Einmalcode. In der Konsole sind sie mit „Code erforderlich“ gekennzeichnet.

Einmalcodes

Tools für Ausgaben und irreversible Aktionen benötigen zusätzlich den Parameter totp_code mit dem aktuellen 6-stelligen Code Ihrer Authenticator-App. Die KI kann diesen Code nicht selbst erhalten und fragt Sie bei Bedarf danach. Gleiches gilt für Tools mit „Code erforderlich“.

  • Jeder Code ist nur einmal verwendbar. Ein gerade in der Konsole genutzter Code kann auch über MCP nicht erneut verwendet werden.
  • Ohne aktivierte Zwei-Faktor-Authentifizierung werden diese Tools stets abgewiesen, mit einem Hinweis zur Aktivierung in der Konsole.
  • Der Code wird vor allen anderen Schritten geprüft. Ein falscher Code verbraucht daher kein Tagesbudget.

Ausgabenlimits

Jeder kostenpflichtige Aufruf durchläuft diese vier Schritte der Reihe nach. Scheitert ein Schritt, wird kein Geld abgebucht.

confirmed_total_usd

Die meisten kostenpflichtigen Tools benötigen confirmed_total_usd: den Gesamtbetrag, den die KI Ihnen genannt hat und dem Sie zugestimmt haben. Ist der Preis bei Ausführung höher, wird nichts ausgeführt und die KI nennt Ihnen den neuen Preis.

Tagesbudget bei Fehlschlägen

Scheitert ein Aufruf und steht fest, dass nichts berechnet wurde, wird die Reservierung freigegeben. Ist die Abbuchung ungewiss, bleibt der Betrag reserviert, damit eine möglicherweise erfolgte Belastung nicht aus der Zählung fällt. Ihre Rechnungen zeigen die tatsächlichen Belastungen.

Ratenlimits und in Ihrem Namen gesendete Inhalte

Zusätzlich zum eigenen Ratenlimit gelten für Tools, die Inhalte in Ihrem Namen schreiben oder Live-Anfragen an Telegram senden, kontoweite Limits. Diese werden von allen Zugangsdaten des Kontos gemeinsam genutzt und täglich um 00:00 UTC+8 zurückgesetzt. Aufrufe über dem Limit werden abgewiesen und die KI zum Stoppen aufgefordert. Identische Community-Beiträge und Support-Nachrichten innerhalb von 10 Minuten werden ebenfalls abgewiesen. E-Mails werden anhand ihres Idempotenzschlüssels statt des Inhalts dedupliziert. In der Konsole sind diese Tools mit „Ratenbegrenzt“ gekennzeichnet.

In Ihrem Namen gesendete Inhalte

Nach Aktivierung der entsprechenden Tools kann die KI in Ihrem Namen Community-Beiträge und Antworten veröffentlichen, den Live-Support anschreiben und E-Mails über Ihr SMTP-Konto senden. Diese Inhalte vertreten Sie, und Sie tragen dafür die Verantwortung:

Ressourcen und Prompts

Zusätzlich zu Tools stellt der Server drei schreibgeschützte Ressourcen und drei direkt nutzbare Prompts bereit.

  • tovanix://catalog — Funktionskatalog: alle Bereiche und Funktionen sowie deren Freigabe für diese Zugangsdaten. Die KI liest ihn bei „nicht autorisiert“ oder auf die Frage, was sie tun kann.
  • tovanix://account/overview — Kontoübersicht: Kontostatus, genutzte Dienste sowie Berechtigungen und Tagesbudgetverbrauch dieser Zugangsdaten. Das Guthaben wird nur angezeigt, wenn „Kontoguthaben ansehen“ aktiviert ist.
  • tovanix://guide — Plattformleitfaden: Darstellung von Beträgen und Währungen, Bestellstatus und erforderliche Bestätigungen vor einer Bestellung.
  • account_health — — — Kontoprüfung: Guthaben, Abonnements und Ablaufdaten verschiedener Dienste, ungewöhnliche Bestellungen und eine Aufgabenliste.
  • spend_report — days, Standard 30 — Ausgabenbericht: aktuelle Rechnungen und nach Dienst zusammengefasste Ausgaben.
  • renewal_check — within_days, Standard 14 — Ablaufprüfung: bald ablaufende Dienste und Verlängerungskosten — es wird nichts automatisch verlängert.

Fehler und Fehlerbehebung

Verbindungs- und Authentifizierungsprobleme werden als HTTP-Statuscodes zurückgegeben. Fachliche Fehler erscheinen als Tool-Ergebnisse (isError: true), deren Text der KI den nächsten Schritt nennt, etwa „Nutzer nach einem Einmalcode fragen“ oder „Guthaben unzureichend — Nutzer zuerst um Aufladung bitten“.

Tovanix MCP aus verschiedenen KI-Werkzeugen verbinden

Ersetzen Sie <YOUR_MCP_CREDENTIAL> durch den in der Konsole erstellten MCP-Zugangsschlüssel.

  • Claude Code — Im Terminal ausführen
    claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Codex — Konfigurationsdatei: ~/.codex/config.toml
    [mcp_servers.tovanix]
    url = "https://tovanix.com/api/mcp/rpc"
    bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"
  • Cursor — Konfigurationsdatei: ~/.cursor/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • GitHub Copilot (VS Code) — Konfigurationsdatei: .vscode/mcp.json
    {
      "servers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer ${input:tovanix-credential}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "tovanix-credential",
          "description": "Tovanix MCP credential",
          "password": true
        }
      ]
    }
  • Gemini CLI — Konfigurationsdatei: ~/.gemini/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "httpUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • OpenCode — Konfigurationsdatei: ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Qwen Code — Im Terminal ausführen
    qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Kimi Code CLI — Konfigurationsdatei: ~/.kimi-code/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • CodeBuddy Code — Im Terminal ausführen
    codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc
  • Qoder CLI — Konfigurationsdatei: ~/.qoder/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamable-http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kiro — Konfigurationsdatei: ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae — Konfigurationsdatei: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CN — Konfigurationsdatei: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CLI — Konfigurationsdatei: trae_cli.yaml
    mcp_servers:
      - name: "tovanix"
        url: "https://tovanix.com/api/mcp/rpc"
        type: "http"
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
  • GitHub Copilot CLI — Konfigurationsdatei: ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          },
          "tools": [
            "*"
          ]
        }
      }
    }
  • Cline — Konfigurationsdatei: cline_mcp_settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamableHttp",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kilo Code — Konfigurationsdatei: ~/.config/kilo/kilo.jsonc
    {
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Continue — Konfigurationsdatei: ~/.continue/config.yaml
    mcpServers:
      - name: tovanix
        type: streamable-http
        url: https://tovanix.com/api/mcp/rpc
        requestOptions:
          headers:
            Authorization: Bearer <YOUR_MCP_CREDENTIAL>
  • Zed — Konfigurationsdatei: ~/.config/zed/settings.json
    {
      "context_servers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Junie — Konfigurationsdatei: ~/.junie/mcp/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Amp — Konfigurationsdatei: ~/.config/amp/settings.json
    {
      "amp.mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Goose — Konfigurationsdatei: ~/.config/goose/config.yaml
    extensions:
      tovanix:
        enabled: true
        type: streamable_http
        name: tovanix
        uri: https://tovanix.com/api/mcp/rpc
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
        timeout: 300
  • Augment (Auggie) — Im Terminal ausführen
    auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"
  • Factory Droid — Im Terminal ausführen
    droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth
  • Crush — Konfigurationsdatei: ~/.config/crush/crushrc
    mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"
  • Warp — In die App-Einstellungen einfügen
    {
      "tovanix": {
        "url": "https://tovanix.com/api/mcp/rpc",
        "headers": {
          "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
        }
      }
    }
  • Windsurf — Konfigurationsdatei: ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "tovanix": {
          "serverUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Claude (Web / Desktop) — Adresse in der App eingeben und den Header Authorization hinzufügen (Bearer + Zugangsschlüssel)
    https://tovanix.com/api/mcp/rpc
  • LM Studio — Konfigurationsdatei: mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Dify — Adresse in der App eingeben und den Header Authorization hinzufügen (Bearer + Zugangsschlüssel)
    https://tovanix.com/api/mcp/rpc
  • Coze — Adresse in der App eingeben und den Header Authorization hinzufügen (Bearer + Zugangsschlüssel)
    https://tovanix.com/api/mcp/rpc
  • n8n — Adresse in der App eingeben und den Header Authorization hinzufügen (Bearer + Zugangsschlüssel)
    https://tovanix.com/api/mcp/rpc
  • Andere MCP-Clients — In die App-Einstellungen einfügen
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }

Häufig gestellte Fragen

Warum liefert tools/list eine leere Liste?

Für den Zugangsschlüssel sind noch keine Funktionen freigeschaltet. Aktivieren Sie die benötigten Funktionen unter „MCP-Zugriff“ in der Konsole und verbinden Sie den Client erneut.

Warum werden Ausgabenwerkzeuge immer abgelehnt?

Prüfen Sie drei Punkte: Stehen die Ausgabenlimits noch auf dem Standardwert 0, ist die Zwei-Faktor-Authentifizierung aktiviert und ist das Tageslimit bereits ausgeschöpft?

Verwandte Seiten: Lassen Sie Ihren KI-Assistenten Ihr Tovanix-Konto verwalten · API-Dokumentation · Entwicklerintegration

Wird geladen…