AI 에이전트 연결 (MCP)

DataSinking은 MCP 서버입니다. 에이전트가 이 서버를 바라보게 하면 중국, 한국, 일본, 대만의 공시 전문을 자연어로 검색하고 읽을 수 있습니다 — 코드 없이, 6개 도구로. 먼저 키를 발급받으세요 — 무료 키 받기. API 레퍼런스의 일부입니다.

클라이언트 선택

클라이언트설정 파일호스팅 URL 사용 가능 여부
Claude Code~/.claude.json, .mcp.json가능
Claude Desktopclaude_desktop_config.json + Connectors UIUI 경유
Cursor.cursor/mcp.json가능
OpenAI Codex CLI~/.codex/config.toml가능
WorkBuddy / CodeBuddy~/.workbuddy/mcp.json, ~/.codebuddy/.mcp.jsonCodeBuddy만
그 외command + args + env보통 가능
DeepSeek (Harness dsh)~/.dsh/cordis.patch.yml (YAML)가능
Windsurf / Devin~/.config/devin/mcp_config.json가능

호스팅 엔드포인트

URL 하나면 끝입니다. 설치할 것도, PC에 Python이나 Node도 필요 없습니다. 인증은 bearer 헤더로 하며, 헤더를 설정할 수 없는 클라이언트에는 ?apikey=를 씁니다.

https://api.datasink.ing/mcp

Authorization: Bearer YOUR_KEY      # or: https://api.datasink.ing/mcp?apikey=YOUR_KEY

아래 클라이언트는 모두 호스팅 방식을 지원하는 경우 그 형태를 보여 줍니다. 지원하지 않는 경우에는 로컬 서버로 대체합니다 — 같은 6개 도구를 npx 또는 uvx로 직접 실행하며, 이때도 설치할 것은 없습니다.

Claude Code

.mcp.json · ~/.claude.json

명령 하나면 됩니다 — 안내가 나오면 키를 입력하고, 연결되었는지 확인하세요:

claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
  --header "Authorization: Bearer YOUR_KEY"

claude mcp list        # → datasinking: ✔ Connected

--scope user를 추가하면 이 프로젝트뿐 아니라 모든 프로젝트에서 쓸 수 있습니다. Claude Code가 서버 상태를 직접 점검하므로, claude mcp get datasinking으로 연결이 실패한 이유를 정확히 알 수 있습니다.

전체 설정 가이드 →

Claude Desktop

claude_desktop_config.json

Settings → Connectors → Add → Add custom connector에서 https://api.datasink.ing/mcp를 붙여 넣고 인증 안내를 마치세요. 이 설정을 위해 JSON 파일을 편집하지 마세요. mcp-remote도 쓰지 마세요 — 그 파일은 stdio 전용이라 url 키를 받지 않습니다.

전체 설정 가이드 →

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "datasinking": {
      "url": "https://api.datasink.ing/mcp",
      "headers": { "Authorization": "Bearer ${env:DATASINK_API_KEY}" }
    }
  }
}

Cursor는 ${env:NAME} 형식으로 보간합니다 — Claude Code처럼 ${NAME}가 아닙니다. 편집 후 Cursor를 다시 시작하세요. 연결 오류는 Output → MCP Logs에서 확인할 수 있습니다.

전체 설정 가이드 →

OpenAI Codex CLI

~/.codex/config.toml

[mcp_servers.datasinking]
url = "https://api.datasink.ing/mcp"
bearer_token_env_var = "DATASINK_API_KEY"

Codex에는 type 필드가 없습니다 — 전송 방식은 url을 썼는지 command를 썼는지로 추론됩니다. 헤더 키는 headers가 아니라 http_headers이며, bearer_token을 그대로 쓰면 거부됩니다 — 환경 변수를 사용하세요.

전체 설정 가이드 →

WorkBuddy / CodeBuddy (Tencent)

~/.workbuddy/mcp.json · ~/.codebuddy/.mcp.json

이 둘은 설정 파일이 서로 다른 별개의 제품입니다 — 설정이 “적용되지 않는” 가장 흔한 이유입니다:

// WorkBuddy (desktop app) — ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

WorkBuddy의 문서에 나온 설정은 stdio 전용이고, type: "http" 형식은 CodeBuddy Code에서 동작합니다. CodeBuddy는 설정을 ~/.codebuddy/.mcp.json에 보관합니다. 어느 쪽이든 편집 후 앱을 다시 시작하세요.

전체 설정 가이드 →

기타 MCP 클라이언트

command + args + env

로컬, stdio, Node 18+ 또는 Python 3.8+:

{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

# Python instead of Node:
#   "command": "uvx", "args": ["--from", "datasinking[mcp]", "datasinking-mcp"]

전체 설정 가이드 →

에이전트가 사용할 수 있는 것

6개 도구. 각 도구는 REST 엔드포인트와 1:1로 대응하므로, API 레퍼런스 에 있는 것은 무엇이든 질문으로 쓸 수 있습니다.

list_exchanges어떤 시장을 지원하는지, 그리고 규모는 얼마나 되는지
list_stocks한 거래소의 종목
list_reports한 종목의 공시 — 메타데이터만
get_report공시 하나, 전체 텍스트
list_sections공시의 장 제목 목록과 분량
get_section한 장만 — 토큰 효율적, RAG에 가장 적합

첫 테스트로 “DataSinking은 어떤 거래소를 지원하나요?”를 물어보세요 — 에이전트가 list_exchanges를 호출하면 전체 연결이 동작한다는 증거입니다. 그다음에는 “도요타 최신 연간 보고서는 리스크에 대해 뭐라고 하나요?”를 시도해 보세요.

연결되지 않을 때

호스팅 엔드포인트는 POST 전용이고 상태를 저장하지 않습니다. 대부분의 연결 실패는 이 두 가지 때문입니다 — 클라이언트는 보통 그 반대를 가정하기 때문입니다:

401{"detail":"Missing API key"} — 아무것도 전송되지 않았습니다. {"detail":"无效的 API key"} — 키가 인식되지 않았습니다.
405GET을 사용했습니다. SSE 스트림은 없습니다 — POST 전용입니다.
no tools클라이언트를 다시 시작하세요. 클라이언트는 모두 실행 시점에 MCP 설정을 읽습니다.
blank header클라이언트를 실행하기 전에 환경 변수가 설정되지 않았거나, 그 클라이언트에 맞지 않는 보간 문법을 사용했습니다.

“내 클라이언트 설정이 잘못됐다”와 “내 키가 틀렸다”를 구분하려면 클라이언트를 아예 건너뛰고 직접 확인하세요:

curl -s -X POST https://api.datasink.ing/mcp \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

클라이언트별 문제 해결 — 각 클라이언트가 실제로 출력하는 오류 포함 — 은 위에 링크된 가이드의 docs/mcp/에 있습니다.

출처 표기를 유지하세요

모든 응답에는 공시가 나온 공식 플랫폼을 밝히는 source 필드가 있습니다 — cninfo.com.cn (중국), DART (한국), EDINET (일본), MOPS (대만). MCP 도구 설명에는 인용할 때 이 필드를 유지하라고 모델에 지시하고 있습니다. 재배포할 때도 이 필드를 제거하지 마세요.