Agenti v termináli
Pripojenie Claude Code a Codexu ku CODEXIS AI cez HTTP alebo lokálne stdio.
Na pripojenie potrebujete svoj API kľúč a adresu MCP servera https://vm.codexis.ai/mcp. Kľúč určuje účet CODEXIS AI a čerpanie jeho kreditov.
Nastavenie Codexu v súbore
Codex pre miestnu prácu nastavíte cez ~/.codex/config.toml na počítači, kde beží. Do existujúceho súboru pridajte túto sekciu a nahraďte ukážkový kľúč. Súbor s kľúčom uchovávajte mimo Gitu.
[mcp_servers.codexis]
url = "https://vm.codexis.ai/mcp"
http_headers = { "X-Api-Key" = "api-VAS_KLIC" }Ak kľúč dodávate premennou prostredia, nahraďte riadok http_headers nasledujúcim nastavením. Hodnota vpravo je názov premennej; musí byť dostupná procesu Codex alebo desktopovej aplikácie pri spustení. Export v samostatnom termináli sa do už bežiacej desktopovej aplikácie neprenesie.
env_http_headers = { "X-Api-Key" = "CODEXIS_AGENT_API_KEY" }Spustite novú reláciu a overte registráciu servera. V konverzácii príkaz /mcp zobrazí stav spojenia a dostupné nástroje.
codex mcp listToto nastavenie používa autentizáciu API kľúčom. Príkaz codex mcp login je určený pre OAuth servery. Formát konfigurácie opisuje oficiálna dokumentácia OpenAI.
Claude Code
Do koreňa projektu pridajte .mcp.json, prípadne zlúčte položku codexis so svojimi existujúcimi servermi. Nastavte premennú CODEXIS_AGENT_API_KEY v prostredí, z ktorého spúšťate Claude Code.
{
"mcpServers": {
"codexis": {
"type": "http",
"url": "https://vm.codexis.ai/mcp",
"headers": {
"X-Api-Key": "${CODEXIS_AGENT_API_KEY}"
}
}
}
}Po spustení Claude Code potvrďte použitie projektového MCP servera. Pomocou /mcp overte spojenie a zoznam nástrojov. Prehľad konfigurácie zobrazíte aj z terminálu.
claude mcp listDokumentácia Claude Code opisuje projektovú konfiguráciu a načítanie hlavičiek z premenných prostredia.
Lokálne stdio pre Codex a Claude Code
Stdio použite, ak chcete MCP proces spúšťať u seba, napríklad kvôli prílohám z povoleného miestneho priečinka. Pripravte CLI a prihláste jeho profil. Nasledujúci príkaz číta kľúč zo skrytého vstupu.
codexis-agent-cli auth login --endpoint https://vm.codexis.aiV Codex nastavte namiesto HTTP sekcie tento variant. Príkaz musí byť dostupný v prostredí klienta; pre desktop môžete použiť úplnú cestu k programu.
[mcp_servers.codexis]
command = "codexis-agent-cli"
args = ["mcp", "serve"]V Claude Code zodpovedá rovnakému pripojeniu nasledujúca položka .mcp.json.
{
"mcpServers": {
"codexis": {
"type": "stdio",
"command": "codexis-agent-cli",
"args": ["mcp", "serve"]
}
}
}MCP proces používa uložený profil používateľa, pod ktorým ho klient spustil. Prepínače --read-only a --allow-path môžete doplniť do args podľa návodu MCP. Pri spustení pod iným používateľom pripravte profil v jeho prostredí.
Overenie spojenia a prvá úloha
Najprv požiadajte klienta, aby cez nástroj identity_get overil pripojený účet a cez project_list vypísal projekty. Potom mu môžete zadať vytvorenie projektu, založenie chatu alebo odoslanie správy. Stav konkrétnej odpovede sleduje message_watch; zobrazenie priebežných aktualizácií závisí od klienta.
Pri chybe HTTP 401 skontrolujte kľúč a jeho odovzdanie v X-Api-Key. Pri chybe spojenia overte dostupnosť úplnej MCP URL z miesta, odkiaľ klient volá. Ak chýbajú nástroje, skontrolujte povolenie konektora pre danú reláciu a pravidlá organizácie.