MCP in OpenAI Codex einrichten: codex mcp add für Remote-Server, config.toml für Remote- und stdio-Server, OAuth per codex mcp login und der Tool-Check.

Kurz gesagt: Codex liest seine MCP-Server aus ~/.codex/config.toml, und die CLI bearbeitet diese Datei für Sie. Für einen Remote-Server genügt ein Befehl: codex mcp add unifapi --url https://mcp.unifapi.com. Mit codex mcp list bestätigen Sie, dass er registriert ist, und mit codex mcp login unifapi holen Sie die OAuth-Anmeldung nach, falls sie sich bei der ersten Nutzung nicht geöffnet hat. Die Codex IDE-Extension liest dieselbe Datei; ein einmal hinzugefügter Server steht also im Terminal und in VS Code zur Verfügung.

Codex, der Coding-Agent von OpenAI, unterstützt das Model Context Protocol in der CLI und in der IDE-Extension. Die Konfiguration ist eine einzige TOML-Datei, was Codex zu einem der leichter einzurichtenden Clients macht, aber auch zu einem, bei dem sich leicht subtile Fehler einschleichen: Ein Server in der falschen Tabelle oder ein stdio-Server, der als URL deklariert ist, scheitert still, bis Sie ein Tool anfordern. Diese Anleitung nutzt den UnifAPI-MCP-Server (https://mcp.unifapi.com, öffentliche Live-Daten von Social-Plattformen und dem SEO-Stack) als Beispiel; die Schritte sind für jeden Remote-Server dieselben.

Was Sie brauchen

Die Codex CLI (npm install -g @openai/codex oder brew install codex) oder die Codex-Extension in VS Code, Cursor oder Windsurf. Beide lesen ~/.codex/config.toml.
Ein angemeldetes Codex (codex login). MCP funktioniert mit ChatGPT-Anmeldung und mit einem API-Key.
Für UnifAPI: ein UnifAPI-Konto, wenn sich die OAuth-Abfrage öffnet, und Workspace-Credits vor dem ersten abrechenbaren Aufruf. Den Katalog zu durchstöbern ist kostenlos.

Einen Remote-Server mit codex mcp add hinzufügen

Ein Remote-Server (Streamable HTTP) ist eine URL. Registrieren Sie ihn:

codex mcp add unifapi --url https://mcp.unifapi.com

Prüfen Sie, ob er geschrieben wurde:

codex mcp list
codex mcp get unifapi

codex mcp list gibt jeden konfigurierten Server mit Transport und Auth-Status aus. Startet Codex zum ersten Mal eine Session mit einem OAuth-geschützten Server, öffnet es die Anmeldung in Ihrem Browser. Ist das nicht passiert, oder arbeiten Sie auf einem Rechner ohne Browser, stoßen Sie sie selbst an:

codex mcp login unifapi
# headless: print the URL instead of opening a browser
codex mcp login unifapi --no-browser

Die OAuth-Anmeldung gibt es nur für Streamable-HTTP-Server; ein stdio-Server hat keinen Anmeldeschritt. Das Token landet in Ihrem Keyring (oder in der Credentials-Datei, auf die Codex zurückfällt) und wird über Sessions hinweg wiederverwendet. codex mcp logout unifapi löscht es, und codex mcp remove unifapi entfernt den Server.

Die config.toml dahinter

Alles, was die CLI geschrieben hat, ist schlichtes TOML unter [mcp_servers.<name>]. Für UnifAPI besteht der Eintrag aus einer Zeile:

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

Zwei optionale Felder sind für andere Remote-Server relevant:

[mcp_servers.example]
url = "https://mcp.example.com"
# Read a static bearer token from this environment variable instead of OAuth
bearer_token_env_var = "EXAMPLE_TOKEN"
# Extra headers, literal or sourced from the environment
http_headers = { "X-Client" = "codex" }
env_http_headers = { "X-Tenant" = "EXAMPLE_TENANT" }

UnifAPI akzeptiert bearer_token_env_var mit einem Workspace-API-Key, aber OAuth ist der empfohlene Weg: nichts, was in ein Dotfile wandert, und das Token ist read-only.

Ein lokaler stdio-Server nutzt command und args statt url. Die beiden Formen schließen sich aus; eine Tabelle, die sie mischt, wird abgelehnt:

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Projects"]
env = { "NODE_OPTIONS" = "--max-old-space-size=512" }

Server pro Projekt

Codex legt eine projektbezogene .codex/config.toml (im Repository-Root, sofern das Projekt als vertrauenswürdig gilt) über Ihre Home-Config. Tragen Sie einen Server dort ein, wenn nur ein Repo ihn braucht, und committen Sie die Datei, damit Teamkollegen dieselben Tools bekommen. codex mcp login löst Namen aus der zusammengeführten Konfiguration auf, ein projektbezogener OAuth-Server meldet sich also auf demselben Weg an.

Prüfen, ob die Tools geladen werden

Starten Sie eine Session in einem Projekt und fragen Sie nach etwas, das nur der Server beantworten kann:

Nutze den unifapi-MCP-Server, um die für Reddit verfügbaren Operationen aufzulisten.

Vor der Antwort sollten Sie einen Tool-Aufruf von list_operations sehen. In der IDE-Extension sind die MCP-Server und ihre Tools im Einstellungsbereich der Extension aufgeführt; ein Server mit rotem Status bedeutet dort meist, dass das OAuth-Token fehlt (codex mcp login) oder die URL falsch ist (codex mcp get).

Je nach Approval-Modus (codex --ask-for-approval oder dem Modus, den Sie in der IDE gewählt haben) fragt Codex möglicherweise vor jedem Tool-Aufruf nach. Bei einem Read-only-Server wie UnifAPI können Sie die Aufrufe gefahrlos für die Session erlauben; das Einzige, was ein Aufruf ausgeben kann, sind Workspace-Credits, und get_operation zeigt den Preis pro Datensatz an, bevor call_api läuft.

Eine erste Aufgabe, die die Credits wert ist

Der MCP-Server von UnifAPI stellt einen großen Katalog über drei Tools bereit: list_operations für die Discovery, get_operation für das Schema und ein Aufrufbeispiel und call_api, um eine Operation auszuführen. Codex kommt mit dieser Form gut zurecht, weil es dieselbe Schleife ist, die es für eine CLI nutzt: Befehl nachschlagen, Hilfe lesen, ausführen. Ein begrenzter erster Prompt:

Hole mit den unifapi-MCP-Tools die 20 neuesten öffentlichen Posts des X-Accounts, den du für „OpenAI Developers“ findest, und gib mir eine Tabelle mit Post, Likes, Reposts und einem einzeiligen Thema. Rufe list_operations und get_operation auf, bevor du call_api nutzt.

Abgerechnet wird pro Datensatz öffentlicher Daten in Workspace-Credits (je $0,001; ein Credit für die meisten Datensätze, höhere Mindestpreise stehen im Katalog). Die Modell-Tokens bleiben auf Ihrem OpenAI-Plan. Ein neuer Workspace hat keine Credits, bis er zum ersten Mal aufgeladen wird, was einen einmaligen Bonus mitbringt; laden Sie also vor dem ersten call_api einmal in der UnifAPI-Console auf.

Wenn Sie von einer konkreten Aufgabe ausgehen, geben die Plattform-Agents und der SEO-Agent Codex einen fertigen Prompt und die Liste der Operationen, die es dafür braucht.

Fehlerbehebung

Symptom	Was zu tun ist
`codex mcp list` zeigt den Server, aber Tools erscheinen nie	Neue Session starten; Server werden beim Session-Start geladen. In der IDE das Fenster neu laden
„OAuth login is only supported for streamable HTTP servers“	Die Tabelle enthält `command` statt `url`; stdio-Server haben keinen Anmeldeschritt
Browser-Anmeldung kommt nie zum Abschluss	`codex mcp login unifapi --no-browser` ausführen, die ausgegebene URL in einem beliebigen Browser öffnen und den Callback zurück ins Terminal einfügen
`call_api` gibt `insufficient_credits` zurück	Der Workspace hat noch keine Credits; einmal in der Console aufladen und denselben Prompt erneut ausführen
Der Server verschwindet in einem Repository	Eine projektbezogene `.codex/config.toml` überschreibt Ihre Home-Config; `codex mcp get <name>` zeigt, aus welcher Datei der Eintrag stammt
Tool-Aufrufe werden abgelehnt	Ihr Approval-Modus blockiert sie; für die Session freigeben oder den Modus für dieses Projekt lockern

Geprüfte Quellen

Verfasst am 14. Oktober 2026 anhand der MCP-Konfigurationsreferenz der Codex CLI und der codex mcp-Unterbefehle des aktuellen Release (add, list, get, login, logout, remove) sowie der OpenAI-Entwicklerdokumentation zu Codex MCP. Die Feldnamen in config.toml stammen aus dem Schema der CLI selbst.

Was Sie als Nächstes lesen sollten

MCP-Setup – die Anweisungen zum gehosteten Connector für jeden Client.

So fügen Sie einen MCP-Server zu Claude hinzu – Connectors, claude_desktop_config.json und claude mcp add.

Cursor-MCP-Setup – mcp.json und One-Click-Installationslinks.

Design des MCP-Katalog-Tools – warum der Server drei Tools statt eines pro Endpunkt bereitstellt.