Codex.io Docs MCP Server
공식MCP를 통해 Codex 암호화 데이터 API를 읽어 에이전트가 GraphQL 쿼리를 작성할 수 있습니다.
문서
Codex Docs MCP
AI 코딩 도구에 Codex 문서 MCP 서버를 추가하여 API 문서에 즉시 접근하세요.
Codex 문서는 모델 컨텍스트 프로토콜(MCP) 서버로 제공됩니다. AI 코딩 도구에 추가하면 편집기를 떠나지 않고도 Codex API 문서를 직접 검색하고 참조할 수 있어 정확한 답변을 얻을 수 있습니다.
https://docs.codex.io/mcp
기능
연결되면 AI 도구는 쿼리, 구독, 타입, 가이드를 포함한 전체 Codex API 문서를 검색할 수 있습니다. Codex API에 대해 질문하거나 쿼리 작성에 도움이 필요할 때 자동으로 문서를 참조합니다.
이 MCP 서버는 문서 검색과 AI의 쿼리 작성을 돕기 위한 것입니다. Codex API와 직접 연동되지 않으므로, [GraphQL 엔드포인트](/learn-graphql)나 [SDK](/sdk)를 통해 API 키로 쿼리를 실행해야 합니다.Docs MCP vs Codex Skills
Codex Skills는 AI 에이전트에 API 지식을 미리 로드하여 API와 직접 연동할 수 있게 합니다. Docs MCP는 문서를 검색하게 하여 GraphQL 쿼리를 작성할 수 있도록 합니다.
| Docs MCP | Codex Skills | |
|---|---|---|
| 작동 방식 | MCP 프로토콜을 통해 필요 시 문서 검색 | 사전 로드된 API 지식 — 작업, 인증, 템플릿 |
| 적합한 경우 | 특정 필드, 타입, 가이드 조회 | Codex API와 직접 상호작용 |
| 네트워크 필요? | 예 — MCP 서버에 쿼리 | 오프라인으로 쿼리 작성 가능 (API 호출 시에는 연결 필요) |
최상의 경험을 위해 둘을 함께 사용하세요. 스킬이 쿼리 생성을 처리하고 MCP가 필요할 때 세부 정보를 채워줍니다.
설정
`Cmd+Shift+P`(Mac) 또는 `Ctrl+Shift+P`(Windows/Linux)로 MCP 설정을 열고 **Cursor Settings: Open MCP Settings**를 선택합니다. 다음을 추가하세요:```json theme={null}
{
"mcpServers": {
"codex-docs": {
"url": "https://docs.codex.io/mcp"
}
}
}
```
프로젝트 루트에 `.vscode/mcp.json` 파일을 생성합니다:
```json theme={null}
{
"servers": {
"codex-docs": {
"type": "http",
"url": "https://docs.codex.io/mcp"
}
}
}
```
`~/.codeium/windsurf/mcp_config.json`에서 MCP 구성 파일을 열고 다음을 추가합니다:
```json theme={null}
{
"mcpServers": {
"codex-docs": {
"serverUrl": "https://docs.codex.io/mcp"
}
}
}
```
**Settings > Connectors**로 이동하여 **Add custom connector**를 선택한 후 다음을 입력합니다:
* **Name:** Codex Docs
* **URL:** `https://docs.codex.io/mcp`
다음 명령을 실행합니다:
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
프롬프트 예시
MCP가 연결되면 AI 어시스턴트에게 Codex API를 사용하여 기능을 구축하도록 요청할 수 있습니다. 시작하는 데 도움이 되는 몇 가지 예시입니다.
토큰 가격 조회
"Codex API를 사용하여 이더리움에서 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
}
}
}
가격 차트 렌더링
"솔라나에서 이 토큰의 지난 24시간 동안의 1시간 OHLCV 캔들을 가져와 줘:
So11111111111111111111111111111111111111112."
query {
getBars(
symbol: "So11111111111111111111111111111111111111112:1399811149"
from: 1719792000
to: 1719878400
resolution: "60"
) {
o
h
l
c
volume
t
}
}
실시간 거래 스트리밍
"이더리움에서 토큰의 실시간 스왑 이벤트를 스트리밍하기 위한 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
}
}
}
}
새로운 런치 발견
"솔라나에서 지난 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
}
}
}
이 모든 것을 외울 필요는 없습니다. 원하는 것을 설명하기만 하면 AI 어시스턴트가 문서에서 올바른 쿼리를 찾아줍니다. 위 예시는 가능한 것을 보여주기 위한 것입니다.