Zum Inhalt springen

MCP-Server in Codex CLI einrichten

Welche Form der Konfigurationsdatei Codex CLI liest, wie sie heißt und wo sie liegt – aus der Dokumentation des Herstellers, mit Fundstelle und Abrufdatum.

Form der Datei
Form der DateiTOML mit der Tabelle [mcp_servers.<Name>].
Dateinameconfig.toml

Ablageort

Ablageort
alle Systeme~/.codex/config.toml · .codex/config.toml

Fundstelle: learn.chatgpt.com/docs/extend/mcp?surface=cli, abgerufen am 2026-08-27

In drei Schritten

  1. Legen Sie die Datei config.toml an – bei Codex CLI liegt sie unter ~/.codex/config.toml · .codex/config.toml. Die vollständige Tabelle je Betriebssystem steht oben.
  2. Setzen Sie den Serverblock unter dem Schlüssel [mcp_servers.<name>] ein. Genau dieser Schlüssel unterscheidet die Clients voneinander.

    Beispiel aus dem heutigen Bestand, erzeugt vom Konfigurationsbaukasten dieser Seite. Eintrag: io.github.transloadit/mcp-server

    [mcp_servers.io-github-transloadit-mcp-server]
    command = "npx"
    args = ["-y", "@transloadit/mcp-server"]
    
    [mcp_servers.io-github-transloadit-mcp-server.env]
    TRANSLOADIT_SECRET = ""

    als config.toml laden

    Zum Eintrag dieses Beispiels

  3. Prüfen Sie, dass die Datei gültig bleibt und dass Sie die Werte der geheimen Variablen selbst eintragen: Das Register kennt sie nicht und schreibt nur ihre Namen.

Der Wurzelschlüssel

Eine Datei mit dem falschen Wurzelschlüssel wird gelesen und tut nichts – ohne Fehlermeldung. Deshalb steht die Form hier neben dem Ablageort.

Andere Clients lesen eine andere Form: Claude Desktop, Claude Code, Cursor, Visual Studio Code, Windsurf. Alle Clients im Vergleich

Konfiguration für Codex CLI erzeugen

Der Baukasten baut den Block aus den Registerangaben eines ausgewählten Servers und gibt ihn in genau der Form aus, die Codex CLI liest.

Konfiguration für Codex CLI erzeugen

Wofür der Baukasten eine Datei erzeugen kann

16.884 der 47.245 veröffentlichten Einträge führen eine Paketkoordinate, aus der eine offengelegte Startvorlage einen Block bildet. Die übrigen 30.361 nennen kein Paket oder eine Quelle ohne offengelegte Vorlage; für sie erzeugt der Baukasten nichts und sagt warum.

Wenn es nicht läuft

Wenn es nicht läuft
Der Client liest die Datei und tut nichtsPrüfen Sie Dateipfad und Wurzelschlüssel gemeinsam. Die hier erzeugte Datei für Codex CLI verwendet [mcp_servers.<name>]. Gültiges JSON allein belegt nicht, dass die Datei am gewählten Ort im passenden Format vorliegt.
Der Server startet und meldet fehlende ZugangsdatenDie erzeugten Variablen tragen ihren Namen und einen leeren Wert. Welche Werte hineingehören, steht beim Anbieter – das Register erhebt sie nicht.
Für einen Eintrag entsteht gar kein BlockDann führt der Registereintrag kein Paket, seine Paketquelle hat hier keine offengelegte Vorlage, oder seine Kennung sieht nicht wie ein Paketname aus. Der Baukasten nennt den Grund; erfunden wird nichts.

Einrichten und verbinden

Alle Beiträge

Was hier NICHT steht

Dieses Register führt keine Angabe darüber, welcher Server mit welchem Client zusammenarbeitet. Kein Manifest erklärt eine Clientliste, und das Register erfindet keine. Was hier steht, ist die Form der Datei und ihr Ablageort laut der Dokumentation des Clients – nicht eine Zusage über einen Server.

Fassung der Clientkunde: 1

tracevero · https://tracevero.de/klient/codex