Přejít na obsah
CODEXIS AI

Agenti v terminálu

Připojení Claude Code a Codexu ke CODEXIS AI přes HTTP nebo lokální stdio.

Pro připojení potřebujete svůj API klíč a adresu MCP serveru https://vm.codexis.ai/mcp. Klíč určuje účet CODEXIS AI a čerpání jeho kreditů.

Nastavení Codexu v souboru

Codex pro lokální práci nastavíte přes ~/.codex/config.toml na počítači, kde běží. Do existujícího souboru přidejte tuto sekci a nahraďte ukázkový klíč. Soubor s klíčem uchovávejte mimo Git.

[mcp_servers.codexis]
url = "https://vm.codexis.ai/mcp"
http_headers = { "X-Api-Key" = "api-VAS_KLIC" }

Pokud klíč dodáváte proměnnou prostředí, nahraďte řádek http_headers následujícím nastavením. Hodnota vpravo je název proměnné; musí být dostupná procesu Codex nebo desktopové aplikace při spuštění. Export v samostatném terminálu se do již běžící desktopové aplikace nepřenese.

env_http_headers = { "X-Api-Key" = "CODEXIS_AGENT_API_KEY" }

Spusťte novou relaci a ověřte registraci serveru. V konverzaci příkaz /mcp zobrazí stav spojení a dostupné nástroje.

codex mcp list

Toto nastavení používá autentizaci API klíčem. Příkaz codex mcp login je určený pro OAuth servery. Formát konfigurace popisuje oficiální dokumentace OpenAI.

Claude Code

Do kořene projektu přidejte .mcp.json, případně slučte položku codexis se svými existujícími servery. Nastavte proměnnou CODEXIS_AGENT_API_KEY v prostředí, ze kterého spouštíte Claude Code.

{
  "mcpServers": {
    "codexis": {
      "type": "http",
      "url": "https://vm.codexis.ai/mcp",
      "headers": {
        "X-Api-Key": "${CODEXIS_AGENT_API_KEY}"
      }
    }
  }
}

Po spuštění Claude Code potvrďte použití projektového MCP serveru. Pomocí /mcp ověřte spojení a seznam nástrojů. Přehled konfigurace zobrazíte také z terminálu.

claude mcp list

Dokumentace Claude Code popisuje projektovou konfiguraci a načítání hlaviček z proměnných prostředí.

Lokální stdio pro Codex a Claude Code

Stdio použijte, pokud chcete MCP proces spouštět u sebe, například kvůli přílohám z povolené místní složky. Připravte CLI a přihlaste jeho profil. Následující příkaz čte klíč ze skrytého vstupu.

codexis-agent-cli auth login --endpoint https://vm.codexis.ai

V Codex nastavte místo HTTP sekce tuto variantu. Příkaz musí být dostupný v prostředí klienta; pro desktop můžete použít úplnou cestu k programu.

[mcp_servers.codexis]
command = "codexis-agent-cli"
args = ["mcp", "serve"]

V Claude Code odpovídá stejnému připojení následující položka .mcp.json.

{
  "mcpServers": {
    "codexis": {
      "type": "stdio",
      "command": "codexis-agent-cli",
      "args": ["mcp", "serve"]
    }
  }
}

MCP proces používá uložený profil uživatele, pod kterým ho klient spustil. Přepínače --read-only a --allow-path můžete doplnit do args podle návodu MCP. Při spuštění pod jiným uživatelem připravte profil v jeho prostředí.

Ověření spojení a první úkol

Nejprve požádejte klienta, aby přes nástroj identity_get ověřil připojený účet a přes project_list vypsal projekty. Potom mu můžete zadat vytvoření projektu, založení chatu nebo odeslání zprávy. Stav konkrétní odpovědi sleduje message_watch; zobrazení průběžných aktualizací závisí na klientovi.

Při chybě HTTP 401 zkontrolujte klíč a jeho předání v X-Api-Key. Při chybě spojení ověřte dosažitelnost úplné MCP URL z místa, odkud klient volá. Pokud chybí nástroje, zkontrolujte povolení konektoru pro danou relaci a pravidla organizace.

Kam pokračovat

Přílohy, průběh a ovládání přes MCP · CLI · REST API v2