REST-Schnittstelle
Die Schnittstelle ist in der OpenAPI-Datei beschrieben. Jeder Aufruf sendet den API-Schlüssel des Kontos als Authorization: Bearer <Schlüssel>; der Schlüssel beginnt mit apk_.
OpenAPI-Beschreibung (https://api.codixio.com/openapi/v1.json)
Listing und Zolltarif arbeiten asynchron: POST legt einen Auftrag an und antwortet mit 202 und der Auftrags-Id, GET liefert Stand und Ergebnis. Die E-Rechnung antwortet synchron.
Beschreibungen nimmt der Zolltarif-Dienst in allen Sprachen an. Den Vertrauensgrad „hoch“ vergibt er nur bei Beschreibungen auf Deutsch, bei anderen Sprachen höchstens „mittel“ mit Prüfhinweis.
curl https://api.codixio.com/v1/account -H "Authorization: Bearer apk_…"
Abrechnung
Zuerst greift ein Gratis-Kontingent, sofern gesetzt. Sonst reserviert jeder Aufruf den aktuellen Höchstpreis aus dem Guthaben; ohne Deckung antwortet die Schnittstelle mit 402. Bei Erfolg wird der tatsächliche Preis abgerechnet, bei Fehlschlag die Reservierung freigegeben.
Ohne Anmeldung
Hat der Betreiber für einen Dienst ein Kontingent ohne Anmeldung gesetzt, lässt er sich je IP-Adresse und Tag einige Male gratis nutzen, über die API, den MCP-Server oder den Check auf dieser Website.
Fehler
Fehler des Portals sind Problem Details (RFC 9457) mit code, message und message_language, auf Deutsch oder Englisch nach response_language im Rumpf oder in der Abfrage, sonst nach Accept-Language. Fehler eines Dienstes laufen unverändert durch.
MCP-Server
Der MCP-Server spricht Streamable HTTP und meldet sich per OAuth 2.1 mit dem Codixio-API-Konto an. Neben dem Endpunkt mit allen Werkzeugen gibt es einen Endpunkt je Dienst:
https://api.codixio.com/mcp: alle Werkzeugehttps://api.codixio.com/mcp/listing: Listing-Lokalisierunghttps://api.codixio.com/mcp/tariff: Zolltarifnummerhttps://api.codixio.com/mcp/einvoice: E-Rechnung
Einrichtung in Claude
- In Claude unter Customize > Connectors „Add custom connector“ wählen (auf Team und Enterprise richtet ein Owner Connectoren ein).
- Die Adresse des MCP-Servers eintragen, ohne OAuth-Client-Id; Claude registriert sich selbst.
- „Connect“ wählen, im Codixio-API-Konto anmelden und den Zugriff erlauben.
In Claude Code:
claude mcp add --transport http codixio-api https://api.codixio.com/mcp
Danach mit /mcp anmelden.
Einrichtung in ChatGPT
- Den Entwicklermodus einschalten (laut OpenAI-Hilfe unter Settings > Apps > Advanced settings; auf Business, Enterprise und Edu schaltet ihn der Admin frei).
- Einen eigenen MCP-Server hinzufügen, Name und Beschreibung angeben und als Verbindung den öffentlichen Endpunkt mit der Adresse des MCP-Servers eintragen.
- Als Anmeldung OAuth wählen, die Hinweise bestätigen, anlegen und im Codixio-API-Konto anmelden.
Die Bezeichnungen in der Oberfläche hängen von Plan und Version ab.