에이픽의 모든 API를 MCP(Model Context Protocol)로 제공합니다. API를 직접 연동하지 않아도, AI 도구에 에이픽 MCP 서버 하나만 등록하면 사업자 조회·택배 배송조회·OCR·파일 변환 등 82개 기능을 AI가 대화 중에 직접 호출합니다. 요금은 REST API와 동일하며 사용한 만큼만 포인트가 차감됩니다.
MCP(Model Context Protocol)는 AI가 외부 서비스를 발견하고 호출할 수 있게 하는 공개 표준입니다. REST API의 사용법을 사람(개발자)이 읽고 코드를 작성해야 했다면, MCP는 그 사용법을 AI가 직접 읽고 실행합니다. 에이픽 MCP 서버를 연결한 AI에게 "사업자번호 000-00-00000 조회해줘"라고 말하면, AI가 알맞은 에이픽 기능을 골라 호출하고 결과를 정리해 답합니다.
AI 도구와 에이픽 API 사이에 MCP 게이트웨이가 있습니다. 사용자는 자연어로 요청하고, AI가 Tool 호출로 바꿔 게이트웨이에 보내면, 게이트웨이가 인증·과금을 처리한 뒤 실제 API를 실행해 결과를 돌려줍니다.
기능군별 서버 8개와 전체 통합 서버 1개를 제공합니다. 필요한 기능군만 연결하면 AI의 도구 선택이 더 정확해지고, 전부 필요하면 통합 서버 하나로 충분합니다. 에이픽 MCP 서버는 공식 MCP Registry에 app.apick/* 이름으로 등록되어 있습니다.
📎 표시는 파일 입력 Tool입니다(아래 파일 입력 방식 참고). 요금은 API 목록의 REST 요금과 동일합니다.
curl -X POST "https://apick.app/mcp/business" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
curl -X POST "https://apick.app/mcp/business" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer 인증키" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"parcel_tracking","arguments":{"carrier":"cj","trackingNumber":"123456789012"}}}'
평소에는 이 호출을 직접 작성할 일이 없습니다 — AI 클라이언트가 자동으로 수행합니다. 위 예시는 동작 원리 이해와 디버깅용입니다.
기존 REST API와 동일한 인증키 하나로 인증합니다. 별도 토큰 발급 절차 없이, AI 도구의 서버 설정에 아래 헤더 중 하나를 넣으면 매 호출에 자동으로 포함됩니다.
claude mcp add --transport http apick https://apick.app/mcp/all \
--header "Authorization: Bearer 인증키"
{
"mcpServers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": {
"Authorization": "Bearer 인증키"
}
}
}
}
{
"mcpServers": {
"apick": {
"url": "https://apick.app/mcp/all",
"headers": {
"Authorization": "Bearer 인증키"
}
}
}
}
{
"mcpServers": {
"apick": {
"serverUrl": "https://apick.app/mcp/all",
"headers": {
"Authorization": "Bearer 인증키"
}
}
}
}
{
"servers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": {
"Authorization": "Bearer 인증키"
}
}
}
}
특정 기능군만 쓰려면 URL의 /mcp/all을 위 표의 그룹 URL(예: /mcp/business)로 바꾸면 됩니다.
연결 후 AI에게 이렇게 요청해 보세요. AI가 알맞은 에이픽 Tool을 골라 호출하고 결과를 정리해 줍니다.
OCR·파일 변환처럼 파일을 받는 Tool(📎)은 image_url / file_url 형태의 파라미터로 파일의 https URL을 전달합니다. 에이픽 서버가 URL에서 파일을 내려받아 처리하므로, AI에게 공개적으로 접근 가능한 파일 URL을 알려주면 됩니다. Tool별 허용 형식과 최대 크기는 각 Tool의 파라미터 설명에 표시됩니다. 결과가 파일인 경우 8MB까지 응답에 직접 담아 반환합니다.