> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit MCP-Server mit OpenAI Codex verbinden

> Füge Didit per Befehl zu OpenAI Codex hinzu: codex mcp add didit --url https://mcp.didit.me/mcp. Dann bei Didit anmelden. Kein API-Schlüssel nötig.

OpenAI Codex verbindet sich mit einem einzigen Befehl mit dem gehosteten Didit-MCP-Server (`https://mcp.didit.me/mcp`). Anschließend öffnet Codex im Browser **Log in with Didit** und speichert die Anmeldung für Sie, es muss also kein API-Schlüssel kopiert werden. Dieselbe Konfiguration gilt sowohl für die Codex-CLI als auch für die Codex-IDE-Erweiterung.

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

***

## Einrichtung

**1. Server hinzufügen**

```bash theme={null}
codex mcp add didit --url https://mcp.didit.me/mcp
```

Codex schreibt den Server in `~/.codex/config.toml`, erkennt, dass OAuth benötigt wird, und startet die Anmeldung sofort. Wenn Sie den Vorgang abbrechen, führen Sie später `codex mcp login didit` aus.

**2. Bei Didit anmelden**

Ihr Browser öffnet **Codex wants to access your Didit account**. Wählen Sie die Organisationen aus, die verbunden werden sollen, prüfen Sie die Berechtigungen und klicken Sie auf **Approve**. Das Terminal zeigt `Successfully logged in to MCP server 'didit'.` an.

**3. Bestätigen**

```bash theme={null}
codex mcp list
```

Die Zeile `didit` zeigt den Status `enabled` und die Authentifizierung `OAuth` an.

Möchten Sie die Datei lieber selbst bearbeiten? Dies ist der gesamte Eintrag in `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
```

Führen Sie anschließend `codex mcp login didit` aus, um sich anzumelden.

> [!NOTE]
>
> **Kein API-Schlüssel in der Konfiguration.** Der Server verwendet OAuth 2.1 mit PKCE und handelt in Ihrem Namen: nur in den Organisationen, die Sie bei der Anmeldung genehmigen, und mit den Berechtigungen Ihrer Rolle. Codex identifiziert sich mit einem Client-ID-Metadatendokument. Siehe [Authentifizierung](https://docs.didit.me/de/integration/mcp/authentication.md).

***

## Überprüfen, ob es funktioniert

Starten Sie Codex und stellen Sie eine Frage, in der Sie den Server nennen:

```text theme={null}
Use the didit MCP server: call didit_context_get and list my organizations and applications.
```

Codex lädt MCP-Tools bei Bedarf, deshalb sollten Sie in Ihrer ersten Anfrage den Didit-Server oder das Tool nennen. Codex ruft `didit_context_get` auf und listet Ihre Organisationen mit den zugehörigen Anwendungen auf.

Um eine Sitzung fokussiert zu halten, beschränken Sie Codex mit `enabled_tools` auf die Tools, die Sie benötigen:

```toml theme={null}
[mcp_servers.didit]
url = "https://mcp.didit.me/mcp"
enabled_tools = ["didit_context_get", "didit_session_create", "didit_session_list", "didit_session_get_decision"]
```

`disabled_tools` macht das Gegenteil. Die Tool-Namen finden Sie in der [Tool-Referenz](https://docs.didit.me/de/integration/mcp/tools.md).

***

## Fehlerbehebung

* **`Not logged in` in `codex mcp list`.** Führen Sie `codex mcp login didit` aus und schließen Sie die Anmeldung im Browser ab.
* **Auf einem Remote-Rechner ohne Browser.** Führen Sie `codex mcp login didit` aus, öffnen Sie die ausgegebene URL auf Ihrem eigenen Computer und lassen Sie das Terminal laufen, bis die Anmeldung abgeschlossen ist. Der Callback wird an einen lokalen Port auf dem Rechner geleitet, auf dem Codex läuft. Leiten Sie diesen Port daher bei Bedarf weiter.
* **Ein Tool antwortet mit `missing_scope`.** Ihrer Rolle in dieser Organisation fehlt die Berechtigung. Siehe [Rollen und Berechtigungen](https://docs.didit.me/de/integration/mcp/authentication.md#rollen-und-berechtigungen).
* **So melden Sie sich ab:** `codex mcp logout didit`.

***

## Nächste Schritte

> [card] [ChatGPT verbinden](https://docs.didit.me/de/integration/mcp/chatgpt.md)
>
> Das Didit-Plugin im ChatGPT-Verzeichnis oder der vollständige Server als benutzerdefinierter MCP-Server.

> [card] [Claude verbinden](https://docs.didit.me/de/integration/mcp/claude.md)
>
> Ein-Klick-Connector-Link für Claude im Web, Desktop und Code.

> [card] [Tools-Referenz](https://docs.didit.me/de/integration/mcp/tools.md)
>
> Alles, was der Agent aufrufen kann, Tool für Tool.

> [card] [Beispiel-Prompts](https://docs.didit.me/de/integration/mcp/examples.md)
>
> Längere, ausgearbeitete Beispiele mit echten Payloads.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.