Codex.io Docs MCP

공식

MCP를 통해 Codex 암호화 데이터 API를 읽어 에이전트가 GraphQL 쿼리를 작성할 수 있습니다.

Codex Io Docs MCP(으)로 무엇을 할 수 있나요?

  • Codex API 문서 검색 — 코딩하는 동안 어시스턴트에게 Codex 문서에서 쿼리, 구독, 타입, 가이드를 찾아보도록 요청하세요.
  • GraphQL 쿼리 작성 — 원하는 데이터를 설명하면 어시스턴트가 문서를 참고해 이에 맞는 Codex GraphQL 쿼리를 작성합니다.
  • 필드 및 타입 조회 — 어시스턴트에게 Codex API 문서에서 특정 필드, 인수 또는 타입 정의를 찾아보도록 요청하세요.
  • 필요할 때 가이드 참고 — 작업 중에 관련 Codex 가이드나 예제를 문서에서 가져오도록 요청하세요.

문서

Codex Docs MCP

Codex 문서 MCP 서버를 Claude Code, Cursor 및 기타 AI 코딩 도구에 추가하여 개발 중에 Codex API 문서를 검색할 수 있도록 하세요.

Codex 문서는 Model Context Protocol (MCP) 서버로 제공됩니다. AI 코딩 도구에 이 서버를 추가하면 Codex API 문서를 직접 검색하고 참조할 수 있으므로, 편집기를 벗어나지 않고도 정확한 답변을 얻을 수 있습니다.

https://docs.codex.io/mcp

기능

연결하면 AI 도구가 쿼리, 구독, 타입, 가이드를 포함한 전체 Codex API 문서를 검색할 수 있습니다. Codex API에 관해 질문하거나 쿼리 작성에 도움이 필요할 때 문서를 자동으로 참조합니다.

[!NOTE]

이 MCP 서버는 문서를 검색하고 AI가 쿼리를 작성하도록 돕는 용도입니다. Codex API와 직접 통신하지는 않습니다. API 키를 사용해 GraphQL endpoint 또는 SDK로 쿼리를 실행해야 합니다.

Docs MCP와 Codex Skills 비교

Codex Skills는 AI 에이전트에 API에 대한 사전 지식을 제공하여 API와 직접 통신할 수 있도록 합니다. Docs MCP는 문서를 검색해 GraphQL 쿼리 작성을 도울 수 있습니다.

Docs MCPCodex Skills
작동 방식MCP 프로토콜을 통해 필요할 때 문서 검색사전 로드된 API 지식 — 작업, 인증, 템플릿
적합한 용도특정 필드, 타입 또는 가이드 조회Codex API와 직접 상호작용
네트워크 필요 여부예 — MCP 서버에 쿼리오프라인으로 쿼리 작성 가능 (API 호출에는 여전히 연결 필요)

최상의 경험을 위해 둘 다 함께 사용하세요. skill은 쿼리 생성을 담당하고, MCP는 필요할 때 세부 정보를 보완합니다.

설정

[!NOTE]

Codex (codex.io)는 블록체인 데이터 API입니다. 코딩 에이전트인 OpenAI Codex와는 다릅니다. 아래 설명처럼 이 MCP 서버를 OpenAI Codex에 추가할 수도 있습니다.

[tab] Cursor

Cmd+Shift+P (Mac) 또는 Ctrl+Shift+P (Windows/Linux)로 MCP 설정을 열고 Cursor Settings: Open MCP Settings를 선택합니다. 다음을 추가하세요.

{
  "mcpServers": {
    "codex-docs": {
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] VS Code

프로젝트 루트에 .vscode/mcp.json 파일을 만듭니다.

{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Windsurf

~/.codeium/windsurf/mcp_config.json에서 MCP 구성 파일을 열고 다음을 추가합니다.

{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}

[tab] Claude Desktop

Settings > Connectors로 이동해 Add custom connector를 선택한 다음 다음을 입력합니다.

  • Name: Codex Docs
  • URL: https://docs.codex.io/mcp

[tab] Claude Code

다음 명령을 실행합니다.

claude mcp add --transport http codex-docs https://docs.codex.io/mcp

[tab] OpenAI Codex

다음을 실행합니다.

codex mcp add codex-docs --url https://docs.codex.io/mcp

또는 ~/.codex/config.toml에 다음을 추가합니다.

[mcp_servers.codex-docs]
url = "https://docs.codex.io/mcp"

프롬프트 예시

MCP에 연결하면 AI 어시스턴트에게 Codex API를 사용한 기능 구현을 요청할 수 있습니다. 시작하는 데 도움이 되는 예시는 다음과 같습니다.

토큰 가격 조회

"Codex API를 사용해 Ethereum에서 WETH의 현재 USD 가격을 가져와."

어시스턴트는 getTokenPrices 쿼리를 찾아 다음과 같은 코드를 작성합니다.

query {
  getTokenPrices(
    inputs: [
      {
        address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
        networkId: 1
      }
    ]
  ) {
    address
    priceUsd
  }
}

인기 토큰 피드 만들기

"Base에서 24시간 거래량 기준으로 정렬된 인기 토큰 상위 10개를 가져오는 방법을 알려줘."

query {
  filterTokens(
    filters: { network: [8453] }
    rankings: [{ attribute: volume24, direction: DESC }]
    limit: 10
  ) {
    results {
      token {
        name
        symbol
        address
      }
      volume24
      priceUSD
      change24
    }
  }
}

가격 차트 렌더링

"Solana에서 이 토큰의 지난 24시간 동안 1시간 단위 OHLCV 캔들을 가져와: So11111111111111111111111111111111111111112."

query {
  getBars(
    symbol: "So11111111111111111111111111111111111111112:1399811149"
    from: 1719792000
    to: 1719878400
    resolution: "60"
  ) {
    o
    h
    l
    c
    volume
    t
  }
}

실시간 거래 스트리밍

"Ethereum에서 토큰의 스왑 이벤트를 실시간으로 스트리밍하는 WebSocket 구독을 설정해."

subscription {
  onEventsCreated(
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    networkId: 1
  ) {
    address
    networkId
    events {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
    }
  }
}

지갑 보유 자산 추적

"Base에서 지갑의 모든 토큰 잔액을 가져와."

query {
  balances(
    input: {
      walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      networks: [8453]
    }
  ) {
    items {
      tokenAddress
      balance
      shiftedBalance
      token {
        name
        symbol
      }
    }
  }
}

신규 출시 토큰 찾기

"Solana에서 지난 1시간 이내에 출시되었고 유동성이 $10k 이상인 토큰을 찾아줘."

query {
  filterTokens(
    filters: {
      network: [1399811149]
      liquidity: { gte: 10000 }
      createdAt: { gte: 1719874800 }
    }
    rankings: [{ attribute: createdAt, direction: DESC }]
    limit: 20
  ) {
    results {
      token {
        name
        symbol
        address
      }
      liquidity
      priceUSD
      createdAt
    }
  }
}

[!TIP]

이 내용을 외울 필요는 없습니다. 원하는 것을 설명하기만 하면 AI 어시스턴트가 문서에서 적절한 쿼리를 찾아줍니다. 위 예시는 가능한 작업을 보여주기 위한 것입니다.

이 문서는 개발자 문서 플랫폼인 Mintlify에서 제작 및 호스팅됩니다.