Dodaj konektor MCP do Codex CLI

Konektor pozwala asystentowi korzystać z innego narzędzia lub usługi, na przykład z usługi z dokumentacją albo z przeglądarki. Konektory korzystają ze wspólnego standardu o nazwie MCP (Model Context Protocol). Sam konektor nazywa się serwerem MCP.

Codex obsługuje dwa rodzaje konektorów:

• Lokalny (STDIO): konektor działa na Twoim komputerze. Dodajesz go komendą, która go uruchamia.
• Zdalny (Streamable HTTP): konektor działa w internecie, pod adresem internetowym.

Znajdź komendę startową konektora

Otwórz oficjalną stronę konektora, który chcesz dodać, i poszukaj jego komendy startowej. Na przykład będzie to komenda zaczynająca się od npx. Dodawaj tylko konektory od osób, którym ufasz.

Dodaj konektor

Wpisz tę komendę w zwykłym terminalu, a nie w sesji Codex. Wzór wygląda tak:

$ codex mcp add <server-name> --env VAR1=VALUE1 --env VAR2=VALUE2 -- <stdio server-command>

Nazwę wybierasz Ty. Część --env przekazuje do konektora ustawienie, na przykład klucz. Pomiń ją, jeśli konektor nie potrzebuje klucza. Wszystko po -- to komenda startowa.

W przykładzie OpenAI dodaje Context7, darmowy konektor do dokumentacji dla programistów:

$ codex mcp add context7 -- npx -y @upstash/context7-mcp

Komenda npx wymaga Node.js na komputerze. Node.js to darmowy program, który uruchamia wiele konektorów.

Sprawdź, czy się udało

Wyświetl listę konektorów w terminalu:

$ codex mcp list

W sesji Codex wpisz /mcp. Zobaczysz konektory i narzędzia, z których Codex może korzystać w tej chwili.

Jeśli konektor wymaga zalogowania, uruchom codex mcp login <server-name>.

Dowiedz się, gdzie Codex zapisuje konektory

Codex zapisuje konektory w pliku ustawień ~/.codex/config.toml, w sekcji [mcp_servers.<server-name>]. Konektory dla jednego projektu możesz też umieścić w pliku .codex/config.toml wewnątrz tego projektu. Codex czyta ustawienia projektu tylko w projektach, którym ufasz. Aplikacja ChatGPT na komputer i rozszerzenie Codex do IDE korzystają z tych samych ustawień.

Aby zobaczyć wszystkie komendy konektorów, uruchom codex mcp --help. Konektory, które sprawdziliśmy, znajdziesz na naszej liście konektorów.