AI 에이전트 연결 (MCP)
DataSinking은 MCP 서버입니다. 에이전트가 이 서버를 바라보게 하면 중국, 한국, 일본, 대만의 공시 전문을 자연어로 검색하고 읽을 수 있습니다 — 코드 없이, 6개 도구로. 먼저 키를 발급받으세요 — 무료 키 받기. API 레퍼런스의 일부입니다.
클라이언트 선택
| 클라이언트 | 설정 파일 | 호스팅 URL 사용 가능 여부 |
| Claude Code | ~/.claude.json, .mcp.json | 가능 |
| Claude Desktop | claude_desktop_config.json + Connectors UI | UI 경유 |
| Cursor | .cursor/mcp.json | 가능 |
| OpenAI Codex CLI | ~/.codex/config.toml | 가능 |
| WorkBuddy / CodeBuddy | ~/.workbuddy/mcp.json, ~/.codebuddy/.mcp.json | CodeBuddy만 |
| 그 외 | 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"} — 키가 인식되지 않았습니다. |
| 405 | GET을 사용했습니다. 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 도구 설명에는 인용할 때 이 필드를 유지하라고 모델에 지시하고 있습니다. 재배포할 때도 이 필드를 제거하지 마세요.