Skip to main content
Glama

Grok Codex

버전 0.2.0 · OpenAI Codex Desktop / GUI용 플러그인 + MCP stdio leaf.

xAI Grok를 Codex에서 직접 호출합니다. 오케스트레이션 플러그인의 leaf로 쓰기 좋게 얇게 만들었습니다.

비공식 프로젝트. Grok / xAI 상표는 xAI 소유입니다.
Hermes가 아닙니다. hermes-agent에서 xAI 엔드포인트·헤더·Responses 아이디어만 참고. docs/SOURCE_MAP.md

빠른 시작

codex plugin marketplace add "/path/to/Grok Codex"
codex plugin add grok-codex@grok-codex

python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
export XAI_API_KEY=xai-...

python3 scripts/grok_codex_doctor.py

Related MCP server: grok-build-mcp

구독 로그인 (SuperGrok / X Premium+)

기본 인증은 xAI device-code OAuth (Hermes xai-oauth와 동일 패턴).

python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
python3 scripts/grok_codex_login.py interactive
# 브라우저에서 accounts.x.ai 승인
python3 scripts/grok_codex_login.py status

MCP: grok_codex_login_start → 브라우저 승인 → grok_codex_login_complete

API 키 강제: GROK_CODEX_AUTH_MODE=api_key + XAI_API_KEY

MCP 도구

Tool

역할

grok_codex_consent_status

동의 상태

grok_codex_provider_status

API 키 준비 여부

grok_codex_chat

Chat Completions (기본) 또는 Responses

grok_codex_list_models

모델 목록

grok_codex_doctor

로컬 진단

grok_codex_chat 옵션:

  • api_mode: chat (기본) | responses

  • session_id: 대화 친화 캐시용 (x-grok-conv-id)

환경 변수

변수

의미

XAI_API_KEY

xAI API 키

XAI_BASE_URL

기본 https://api.x.ai/v1

GROK_CODEX_USER_CONSENT=1

프로세스 단위 동의

GROK_CODEX_MODEL

기본 모델

GROK_CODEX_API_MODE

chat 또는 responses

GROK_CODEX_CONFIG_DIR

설정 디렉터리

개발

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest

라이선스

MIT — LICENSE. NOTICE.md.

Available Tools

9 tools
grok_codex_chatC

Chat with Grok. Prefers SuperGrok OAuth; falls back to XAI_API_KEY.

Inputs: model, prompt, system, messages, +3 more.

grok_codex_doctorB

Quick local diagnosis: consent, credentials, default model.

Inputs: no named parameters.

grok_codex_list_modelsA

List curated (and optionally live) models.

Inputs: probe.

grok_codex_login_completeA

Poll until device authorization completes; saves tokens.

Inputs: no named parameters.

grok_codex_login_startC

Start xAI device-code OAuth (SuperGrok / Premium+). Returns verification URL.

Inputs: open_browser.

grok_codex_login_statusA

SuperGrok / xAI OAuth login status (no secrets).

Inputs: no named parameters.

grok_codex_logoutA

Delete local SuperGrok OAuth tokens (does not revoke on xAI).

Inputs: no named parameters.

grok_codex_provider_statusB

Check credentials and readiness without exposing secrets.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: chat, auth flow steps, consent check, diagnosis, model listing, and provider status. No overlap in functionality despite some status-oriented tools.

    Naming Consistency4/5

    All tools share the prefix 'grok_codex_' and mostly follow noun or verb_noun patterns. Minor inconsistency: 'logout' breaks the 'login_*' pattern of the auth group.

    Tool Count5/5

    9 tools is well-scoped for an AI chat assistant with authentication needs. Each tool earns its place, covering chat, auth lifecycle, status checks, and model listing.

    Completeness5/5

    The tool set covers the obvious needs: chatting, authentication (start/complete/status/logout), consent management, diagnosis, provider status, and model listing. No dead ends for core workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers