Openapi.com MCP mit ChatGPT verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Openapi.com Company klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Openapi.com Company + ChatGPT

Italienische und internationale Firmendaten von Openapi.com per USt-IdNr. oder Steuernummer: Firmenprofil in drei Stufen, PEC, SDI-Code, Adresse, Gesellschafter, Stakeholder, wirtschaftlich Berechtigte, Prüfung auf Löschung und MwSt-Gruppe, öffentliche Verwaltungen, Split Payment, Firmensuche, EU-VIES-Prüfung und weltweite Abfragen. Nur lesend; Openapi.com berechnet jeden Aufruf einzeln.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

OPENAPI_COMPANY_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert ein paar Minuten. Du brauchst ein Openapi.com-Konto auf console.openapi.com mit Guthaben in der Wallet oder einem Abo der Company API sowie ein Token mit den Company-Scopes.

1. Melde dich auf console.openapi.com an und lade Guthaben auf oder abonniere die Company API.
2. Erstelle ein Token mit den Company-Scopes, die du brauchst, im Bereich Tokens der Konsole oder über die OAuth API. Ein Scope benennt den Endpunkt, z. B. GET:company.openapi.com/IT-advanced für openapi_company_it_advanced. Ein Token kann mehrere Scopes tragen und gilt bis zu einem Jahr.
3. Kopiere das Token in OPENAPI_COMPANY_TOKEN: nur das Token, ohne Bearer. Der Connector sendet es als Authorization: Bearer ....
4. Installiere den Connector. Prüfe die Verbindung, indem du mit openapi_company_it_start eine USt-IdNr. abfragst, die du kennst; auch dieser Aufruf wird berechnet.

Jeder Aufruf kostet: Openapi.com belastet dein Konto für jede Anfrage, aus dem Wallet-Guthaben oder deinem Abo, zum Preis pro Endpunkt, der auf console.openapi.com steht. Kein Tool ist kostenlos. openapi_company_it_full ist der teuerste Aufruf der API; openapi_company_it_search wird nach Zahl der Treffer und der gewünschten Datenanreicherung berechnet. Die KI nimmt das günstigste Tool, das die Frage beantwortet (openapi_company_it_start oder openapi_company_it_name vor openapi_company_it_advanced, openapi_company_it_advanced vor openapi_company_it_full), wiederholt keine Abfrage, deren Ergebnis sie schon hat, und startet eine Suche zuerst mit dryRun 1: Das liefert die Zahl der Treffer und den Preis, den dir die KI vor der echten Suche nennt.

Scopes entscheiden, was funktioniert: Ein Aufruf an einen Endpunkt, für den das Token keinen Scope hat, antwortet mit 403. Erstelle in dem Fall ein Token mit den GET:company.openapi.com-Scopes, die du brauchst.

Produktion oder Sandbox zum Ausprobieren: Der Connector ruft die Produktion unter https://company.openapi.com auf. Openapi.com betreibt außerdem eine Sandbox unter https://test.company.openapi.com mit eigenen Sandbox-Tokens und einer festen Liste von Testfirmen. Zum Ausprobieren stellst du die Base URL des Connectors auf die Sandbox-Adresse um und nutzt ein Sandbox-Token. Ein Sandbox-Token auf der Produktion antwortet mit 401.

Cloud und Self-Hosting funktionieren gleich: Das Token ist die einzige Zugangsangabe, und der Connector ruft in beiden Fällen dieselbe Openapi.com-Adresse auf.

Welche Länder: Italien in der Tiefe, aus Handelskammer, italienischer Steuerbehörde (Agenzia delle Entrate) und dem IPA-Verzeichnis der öffentlichen Verwaltungen. Für andere EU-Länder prüft openapi_company_eu_vies_check eine USt-IdNr. in VIES, und openapi_company_eu_start liefert Basisdaten für die Präfixe AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI und SK. openapi_company_ww_start und openapi_company_ww_advanced decken Firmen in jedem Land ab, mit erweiterten Daten, wo die Quellen des Landes sie hergeben. Die länderspezifischen Endpunkte von Openapi.com für FR, DE, ES, PT, GB, BE, AT, CH und PL sind nicht enthalten: Die weltweiten Tools ersetzen sie.

Kennungen: Eine italienische USt-IdNr. (Partita IVA) hat 11 Ziffern (12485671007), die Steuernummer (Codice fiscale) einer Firma meist dieselben 11 Ziffern, die eines Einzelunternehmers 16 Zeichen. Antworten enthalten außerdem eine Openapi-id, die die meisten italienischen Tools stattdessen annehmen. openapi_company_eu_vies_check nimmt den Ländercode getrennt (EL für Griechenland), openapi_company_eu_start als Präfix (DE123456789), und die weltweiten Tools nehmen einen ISO-Ländercode aus zwei Buchstaben plus USt-IdNr., Steuernummer, Registernummer oder Openapi-id.

Firmensuche: openapi_company_it_search filtert nach Name (mindestens 3 Zeichen, * als Platzhalter), Provinz, Gemeinde, ATECO-Code, Rechtsform (Codes aus openapi_company_it_legal_forms), Status bei der Handelskammer, Umsatz, Mitarbeitern, Gesellschafter, PEC, SDI-Code oder einem Umkreis um einen Punkt. Ohne dataEnrichment liefert sie nur IDs, mit dataEnrichment Firmendaten, die pro Treffer berechnet werden. Höchstens 1000 Treffer pro Aufruf; weiterblättern mit skip und limit.

Langsame Quellen: Sind die Register langsam, antwortet ein aufwendiger Aufruf wie openapi_company_it_full oder openapi_company_it_stakeholders nach 30 Sekunden mit einer Request-ID und dem Status PENDING. Die KI ruft dann etwas später openapi_company_check_request mit dieser ID auf, statt die Abfrage noch einmal zu bezahlen.

Nicht enthalten: die asynchronen POST-Varianten mit Callbacks, die AML- und Marketing-Pakete und die Änderungsüberwachung (/monitor).

Häufige Fehler: Ein fehlgeschlagener Aufruf enthält success: false, einen error-Code und eine message. 401 heißt, dass das Token fehlt, falsch oder abgelaufen ist oder ein Sandbox-Token auf der Produktion ist. 402 heißt, dass das Konto für diesen Aufruf kein Guthaben mehr hat: Lade auf console.openapi.com auf. 403 heißt, dass dem Token der Scope für diesen Endpunkt fehlt. 404 heißt, dass keine Firma gefunden wurde, 406 eine fehlerhafte USt-IdNr. oder Steuernummer. 429 heißt zu viele Anfragen oder ein ausgelastetes nationales VIES-Register: Warte kurz und versuch es erneut.

Was der Connector liest: für italienische Firmen Name, USt-IdNr., Steuernummer, Adresse und Tätigkeitsstatus; ATECO-Code, Rechtsform, REA-Nummer, Stammkapital, Umsatz und Mitarbeiter der letzten Bilanzen sowie Eintragungs- und Löschungsdatum; die vollständige Akte mit Geschäftsführung und über 400 Bilanzkennzahlen; die PEC mit ihrer Historie und den SDI-Code für E-Rechnungen; Gesellschafter mit mehr als 10 Prozent, Stakeholder, die Firmen, an denen sie beteiligt ist, und die wirtschaftlich Berechtigten; ob eine USt-IdNr. erloschen ist, ob eine Firma zu einer MwSt-Gruppe gehört und ob sie auf den Split-Payment-Listen steht; öffentliche Verwaltungen mit ihren IPA-Ämtern und SDI-Codes; die Codes der Rechtsformen. Für andere Länder: die VIES-Gültigkeit mit Name und Adresse sowie Basis- und erweiterte Firmendaten weltweit.

Nur lesend: Jedes Tool liest nur. Nichts wird in Openapi.com oder in ein Register geschrieben, deshalb ist bei der Installation kein Tool deaktiviert; berechnet wird trotzdem jeder Aufruf.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Openapi.com Company.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Prüf die USt-IdNr. 12485671007, bevor ich eine Rechnung schreibe: Firmenname, ob die Firma noch aktiv ist, SDI-Code und PEC.“
• „Wer sind die Gesellschafter und die wirtschaftlich Berechtigten der Firma mit der USt-IdNr. 12485671007?“
• „Bevor ich dieser Behörde eine Rechnung schicke: Steht sie auf den Split-Payment-Listen, und welche SDI-Codes haben ihre Ämter?“
• „Wie viele aktive Firmen mit dem ATECO-Code 62.01.00 gibt es in der Provinz Mailand? Nenn mir den Preis, bevor du die Suche startest.“
• „Ist die deutsche USt-IdNr. DE123456789 in VIES gültig, und welcher Firmenname ist dazu eingetragen?“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden