Codex-MCP-Server-Konfiguration

MCP (Model Context Protocol) ermöglicht Codex die Integration mit externen Tools und Diensten.

Dieser Abschnitt enthält detaillierte Anweisungen zur Konfiguration und Verwendung von MCP-Servern.


Was ist MCP?

MCP ist ein offenes Protokoll, das eine standardisierte Interaktion zwischen KI-Modellen und externen Tools und Diensten ermöglicht. Über MCP-Server können Sie die Fähigkeiten von Codex erweitern:

  • Dateisystem anbinden
  • Datenbankzugriff
  • Projektmanagement-Tools integrieren
  • Externe API aufrufen
MCP basiert auf dem offenenModel Context Protocol-Build, mit Unterstützung für standardisierte Integration über verschiedene Tools hinweg.

MCP-Basiskonfiguration

Codex-Konfigurationsmenü

Sie können MCP-Dienste über das Einstellungsmenü verwalten oder hinzufügen:

Mit benutzerdefiniertem MCP verbinden:

Speicherort der Konfigurationsdatei

MCP-Server unter~/.codex/config.tomlvonmcp_serversTeilkonfiguration.

Server vom Typ stdio

stdio-MCP-Server konfigurieren

[mcp_servers.filesystem]
# Server-Startbefehl
command = "npx"

# An den Befehl übergebene Argumente
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

# Arbeitsverzeichnis des Servers
cwd = "/path/to/workdir"

# Umgebungsvariablen übergeben
env = {
    NODE_ENV = "production"
}

HTTP-Typ-Server

HTTP-MCP-Server konfigurieren

[mcp_servers.docs]
# MCP-HTTP-Server-Endpunkt
url = "https://docs.example.com/mcp"

# Enthaltene HTTP-Header
http_headers = {
    Authorization = "Bearer token"
}

MCP-Tool-Konfiguration

Verfügbare Tools einschränken

Sie können die vom MCP-Server bereitgestellten Tools einschränken:

Tool-Whitelist/Blacklist

[mcp_servers.filesystem]
# Liste der erlaubten Tools
enabled_tools = ["read_file", "write_file", "list_directory"]

# Liste der verbotenen Tools (angewendet nach enabled_tools)
disabled_tools = ["delete_file"]
Die Verwendung von Tool-Einschränkungen kann die Sicherheit verbessern, indem nur die benötigten Tools verfügbar gemacht werden.

Timeout-Konfiguration

Timeout konfigurieren

[mcp_servers.slow_server]
command = "python"
args = ["-m", "slow_server"]

# Startup-Timeout (Sekunden, Standard 10)
startup_timeout_sec = 30

# Zeitlimit pro Tool-Aufruf (Sekunden, Standard 60)
tool_timeout_sec = 120

MCP-Authentifizierungskonfiguration

OAuth-Konfiguration

OAuth konfigurieren

[mcp_servers.protected]
url = "https://api.example.com/mcp"

# Angeforderte OAuth-Scopes
scopes = ["read", "write"]

# OAuth-Ressourcenparameter
oauth_resource = "codex-integration"

# Umgebungsvariable für Bearer-Token
bearer_token_env_var = "EXAMPLE_API_TOKEN"

HTTP-Header-Konfiguration

HTTP-Header konfigurieren

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

# HTTP-Header aus Umgebungsvariablen befüllen
env_http_headers = {
    X_API_KEY = "MY_API_KEY"
}

# Statische HTTP-Header
http_headers = {
    X_Custom_Header = "value"
}

OAuth-Callback-Konfiguration

OAuth-Callback konfigurieren

# Fester Callback-Port
mcp_oauth_callback_port = 8080

# Benutzerdefinierte Callback-URL
mcp_oauth_callback_url = "https://my-devbox.example.com/callback"

# Speicherort der Anmeldeinformationen
mcp_oauth_credentials_store = "keyring" # file | keyring | auto

MCP-Tool-Berechtigungen

Sie können die Berechtigungen für die Tools jedes MCP-Servers individuell festlegen:

Tool-Berechtigungen konfigurieren

[mcp_servers.docs.tools.search]
# Berechtigungsmodus: ask | approve | deny
approval_mode = "approve"
BerechtigungsmodusBeschreibung
askVor jeder Ausführung fragen (Standard)
approveAutomatisch genehmigen
denyAutomatisch ablehnen
Seien Sie vorsichtig beim Konfigurieren von Tool-Berechtigungen, und erteilen Sie nur Tools, denen Sie vertrauen, Berechtigungen zur automatischen Genehmigung.

Häufige MCP-Server

Dateisystem-Server

Dateisystem-MCP

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

GitHub-Server

GitHub-MCP

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
    GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}

PostgreSQL-Server

PostgreSQL-MCP

[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]

Häufige MCP-Server

Sie können weitere MCP-Server über npm installieren:

# 搜索 MCP 服务器
npm search @modelcontextprotocol/server

# 安装 MCP 服务器
npm install -g @modelcontextprotocol/server-filesystem
OpenAI stellt offiziell eine Vielzahl von MCP-Servern bereit. SieheGitHub-Repository, um die vollständige Liste zu erhalten.

Fehlerbehebung

Server konnte nicht gestartet werden

Prüfen Sie Folgendes:

  • Sind der Befehl und die Parameter korrekt?
  • Sind die erforderlichen Abhängigkeiten installiert?
  • Sind die Umgebungsvariablen korrekt gesetzt?

Zeitüberschreitung bei Tool-Aufruf

Erhöhen Sie die Zeitüberschreitung:

tool_timeout_sec = 120

Authentifizierungsproblem

Stellen Sie sicher, dass der OAuth-Callback-Port nicht belegt ist und der Anmeldeinformationsspeicher korrekt konfiguriert ist.

Nutzungcodex --verboseSie können detaillierte MCP-Debuginformationen anzeigen.

FAQ

F: MCP-Server kann nicht starten?

Prüfen Sie, ob der Befehl korrekt installiert ist; versuchen Sie, den Befehl manuell auszuführen, um zu bestätigen, dass keine Fehler auftreten.

F: Wo werden Tool-Berechtigungen konfiguriert?

In der Konfigurationsdateimcp_servers.<id>.tools.<tool>Teilkonfiguration.

F: Wie deaktiviere ich einen bestimmten MCP-Server?

Zur Konfiguration hinzufügenenabled = falseOder die Konfiguration direkt löschen.

Frage: Wie viele MCP-Server werden unterstützt?

Es gibt keine strikte Begrenzung, aber es wird empfohlen, nur die Server zu konfigurieren, die Sie tatsächlich benötigen.

Weitere Erweiterungen