Nach der Konfiguration des MCP mit Codex wirst du keine Tools mehr sehen. Prüfe zunächst, ob der Server vom aktuellen Client geladen wird, dann überprüfe Start, Authentifizierung und Werkzeugfilterung. Lösche und installiere Konfigurationen nicht sofort neu; Die meisten Probleme lassen sich mit /mcp in codex mcp list oder TUI und einem klaren Neustart finden.
Schritt 1: Bestätigen Sie, dass die Modifikation die gleiche Konfiguration hat
Codex-Apps, CLIs und IDE-Erweiterungen teilen sich Codex-Konfigurationen, wobei der Standardstandort ~/.codex/config.toml ist; Auch vertrauenswürdige Projekte können .codex/config.toml nutzen. Wenn ein anderer CODEX_HOME gesetzt wird oder die Konfigurationsdatei gewechselt wird, kann der aktuelle Client eine weitere Datei lesen. Erstens: Lauf:
codex mcp listWenn kein Zielname in der Liste ist, bedeutet das, dass die Konfiguration von der aktuellen Umgebung nicht gelesen wurde.
Schritt 2: Lass den Client neu laden
Nachdem Sie das MCP in der Codex-App gespeichert haben, klicken Sie auf Neustart; Für IDE-Erweiterungen wählen Sie Erweiterung neu starten. Nachdem Sie eine neue Sitzung in der CLI gestartet haben, geben Sie /mcp in der TUI ein, um den Serverstatus und die verfügbaren Tools zu bestätigen. Wenn du nur config.toml modifizierst, aber die alte Sitzung weiterhin benutzt, kann es sein, dass die Werkzeugliste nicht aktualisiert wird.
Schritt 3: Unterscheide zwischen Startfehler und Authentifizierungsfehler
STDIO-Server basieren auf lokalen Befehlen, Parametern, funktionierenden Verzeichnissen und Umweltvariablen. Kopiere den Startbefehl aus der Konfiguration auf dasselbe Terminal und führe ihn direkt aus; Wenn der Prompt nicht existiert oder Abhängigkeiten fehlen, reparieren Sie zuerst den PATH- und die Laufzeitumgebung. Wenn der HTTP-Server OAuth benötigt, führt er aus:
codex mcp login <服务器名称>Nach der Autorisierung starten Sie den Client neu. Wenn der Server langsam startet, kann er sich startup_timeout_sec verbessern; Die Standard-Startwartezeit beträgt nur 10 Sekunden.
Schritt 4: Überprüfe, ob das Werkzeug gefiltert ist
Konfigurationselement enabled = false deaktiviert den gesamten Server enabled_tools erlaubt nur die aufgeführten Werkzeuge, disabled_tools nach der erlaubten Liste weiterhin Werkzeuge ausschließen. Wenn der Server verbunden ist, aber die Anzahl der Werkzeuge null ist, sollten Sie diese drei Elemente priorisieren, anstatt das Modell zu hinterfragen.
Wenn das Tool weiterhin nicht verfügbar ist, behalten Sie den Status durch /mcp, Startfehler und Serverprotokolle angezeigt. Diese drei können klar unterscheiden zwischen "Konfiguration nicht geladen", "Prozess nicht gestartet", "Autorisierung nicht abgeschlossen" und "Werkzeug gefiltert". Nachfolgende Reparaturen behandeln nur die entsprechende Schicht.
