MCP server APICK
Коммит 11 нояб. 2026 г.Предоставляет 222 инструмента для работы с корейскими бизнес-данными, верификации личности, OCR, отслеживания посылок и генерации изображений и видео с помощью ИИ.
Также известен как lead788/apick-mcp, ocr
- Звёзды
- 1
- Инструменты
- 39
- Загрузки, 30 дней
- —
- Последняя версия
- 1.2.1
- Последний коммит
- 11 нояб. 2026 г.
- Лицензия
- MIT
Что такое APICK MCP?
APICK — это MCP server. Предоставляет 222 инструмента для работы с корейскими бизнес-данными, верификации личности, OCR, отслеживания посылок и генерации изображений и видео с помощью ИИ. Он предоставляет 39 инструментов, например task, limit, req_employment.
Сводка сгенерирована из README проекта
О APICK MCP server
APICK OCR позволяет автоматизировать верификацию корейских компаний и извлечение данных непосредственно из ИИ-агентов. Этот hosted MCP server предоставляет доступ к 222 специализированным инструментам, включая поиск по реестрам юридических лиц, верификацию личности, OCR, отслеживание посылок и генерацию медиаконтента с помощью ИИ. Он разработан для разработчиков, использующих такие клиенты, как Claude Desktop, Cursor, Windsurf или Claude Code, чтобы интегрировать локальные южнокорейские сервисы данных прямо в свои рабочие процессы.
Пользователи подключаются к сервису через HTTP, используя единый API key, полученный на панели управления платформы. Хотя команда tools/list доступна без аутентификации, для выполнения tools/call требуется действующий лицензионный ключ. Сервер размещен удаленно, поэтому локальная установка или обслуживание не требуются. Для сложных задач, таких как генерация изображений или выдача документов, пользователям следует увеличить настройки таймаута клиента как минимум до 660 секунд для обеспечения успешного завершения операций.
Что вы можете с ним делать
- 1Проверка статуса корейских компанийИИ-агент может проверить, является ли конкретный регистрационный номер компании активным на данный момент, и подготовить сводку по данным организации.
- 2Валидация документов, удостоверяющих личностьРазработчики могут использовать сервер для проверки подлинности удостоверений личности, водительских прав или паспортов.
- 3Извлечение текста из изображенийВы можете дать ИИ команду выполнить OCR на изображениях для извлечения текста или конкретных полей из удостоверений личности.
- 4Генерация ИИ-медиаПользователи могут запрашивать создание или редактирование изображений и видео с помощью интегрированных моделей ИИ.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить APICK MCP
Форматы проверены 10 ноя 2026Установка APICK MCP в Claude Code
$ claude mcp add --transport http ocr https://apick.app/mcp/ocrУстановка APICK MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ocr": {
"url": "https://apick.app/mcp/ocr"
}
}
}Установка APICK MCP в VS Code
.vscode/mcp.json
{
"servers": {
"ocr": {
"type": "http",
"url": "https://apick.app/mcp/ocr"
}
}
}Установка APICK MCP в Codex
~/.codex/config.toml
[mcp_servers.ocr] url = "https://apick.app/mcp/ocr"
Установка APICK MCP в Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"ocr": {
"httpUrl": "https://apick.app/mcp/ocr"
}
}
}Инструменты APICK MCP 39
Определено из READMEtasklimitreq_employmentget_employmentreq_personal_incomeget_personal_incomereq_nps_join_historyget_nps_join_historyreq_nps_deduction_certget_nps_deduction_certreq_nps_career_historyget_nps_career_history
| task | — | |
| limit | — | |
| req_employment | — | |
| get_employment | — | |
| req_personal_income | — | |
| get_personal_income | — | |
| req_nps_join_history | — | |
| get_nps_join_history | — | |
| req_nps_deduction_cert | — | |
| get_nps_deduction_cert | — | |
| req_nps_career_history | — | |
| get_nps_career_history | — |
Показать все 39 инструментовПоказать меньше инструментов
req_driving_licenseget_driving_licensereq_health_checkupget_health_checkupreq_cash_receipt_deductionget_cash_receipt_deductionreq_tax_return_historyget_tax_return_historyreq_income_cert_bundleget_income_cert_bundlereq_business_cert_bundleget_business_cert_bundlereq_nps_bundleget_nps_bundlereq_hometax_bundleget_hometax_bundlereq_hometax_biz_bundleget_hometax_biz_bundletransfer_1wonreq_pcccget_pccctts_jobs_canceltts_jobs_resulttts_jobs_subtitlesseedance_jobs_createveo_jobs_createkling_jobs_create
| req_driving_license | — | |
| get_driving_license | — | |
| req_health_checkup | — | |
| get_health_checkup | — | |
| req_cash_receipt_deduction | — | |
| get_cash_receipt_deduction | — | |
| req_tax_return_history | — | |
| get_tax_return_history | — | |
| req_income_cert_bundle | — | |
| get_income_cert_bundle | — | |
| req_business_cert_bundle | — | |
| get_business_cert_bundle | — | |
| req_nps_bundle | — | |
| get_nps_bundle | — | |
| req_hometax_bundle | — | |
| get_hometax_bundle | — | |
| req_hometax_biz_bundle | — | |
| get_hometax_biz_bundle | — | |
| transfer_1won | — | |
| req_pccc | — | |
| get_pccc | — | |
| tts_jobs_cancel | — | |
| tts_jobs_result | — | |
| tts_jobs_subtitles | — | |
| seedance_jobs_create | — | |
| veo_jobs_create | — | |
| kling_jobs_create | — |
Конфигурация
APICK_API_KEY
| Название | Описание | Тип |
|---|---|---|
| APICK_API_KEY | — |
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки
- Связанный и доступный исходный репозиторийlead788/apick-mcp is public and reachablegithub.com/lead788/apick-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-11github.com/lead788/apick-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических уязвимостей в пакете и зависимостяхНе проверялось
- Нет скрытых инструкций для модели39 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённый endpoint отвечает на MCP handshakeinitialize answered with protocol 2025-06-18 in 309 msПройдено
README
Открыть на GitHubAPICK MCP — 222 Korean Data, AI, Image & Video Tools
자동차등록원부 등본은 REST 결과(/rest/get_vehicle_register_doc)에서 원본 PDF와 문서내용을 제공합니다. 전용 MCP 도구는 없습니다. For the vehicle register PDF and structured text, use the REST API or the apick-api SDK.
Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.
대한민국 사업자조회 · 신분증 진위확인 · OCR · 택배 배송조회 · 파일변환 · 웹조회 · LLM을 MCP Tool로.
apick.app — Official site 공식 사이트
Integration guide 연동 가이드 · Full tool catalog 전체 Tool 목록 · API list API 목록
What is this? / 이게 뭔가요?
EN — APICK is a Korean data and AI API platform. This MCP server exposes 222 tools for Korean business data, identity verification, OCR, parcel tracking, image and video generation, file conversion, web intelligence, and LLM calls.
KO — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 Tool 222개로 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 이미지·영상 생성, 파일 변환, 웹 검색과 LLM 호출을 인증키 하나로 제공합니다.
The server is hosted by APICK. Nothing to install, build, or keep running. 서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.
https://apick.app/mcp/all
Quick start / 빠른 시작
1. Get an API key / 인증키 발급
Sign up at apick.app and copy your license key from the dashboard. New accounts get 1,000 free points. apick.app 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 1,000포인트 무료.
tools/listworks without a key — a client can connect and discover all 222 tools before you sign up. Onlytools/callvalidates the key and allowed IP.tools/list는 인증 없이 동작합니다. 가입 전에도 클라이언트가 연결해 222개 Tool을 확인할 수 있고, 키와 허용 IP는tools/call부터 검증합니다.
Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as /32. Changes apply immediately with no separate synchronization.
마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(/32 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
2. Connect / 연결
claude mcp add --transport http apick https://apick.app/mcp/all --header "Authorization: Bearer YOUR_KEY"
Restart Claude Code so the tools load. 툴이 로드되도록 재시작하세요.
{
"mcpServers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
{
"mcpServers": {
"apick": {
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
{
"mcpServers": {
"apick": {
"serverUrl": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
{
"servers": {
"apick": {
"type": "http",
"url": "https://apick.app/mcp/all",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
{
"mcpServers": {
"apick": {
"command": "npx",
"args": ["-y", "apick-mcp", "--server", "all"],
"env": { "APICK_API_KEY": "YOUR_KEY" }
}
}
}
Zero-dependency stdio bridge, Node 18+. 의존성 0개 stdio 브릿지.
Tool wait time / 도구 대기 시간 — Most tools finish within two minutes, but some (speech-to-text, long chats, image generation, registry document issuance) take several minutes. If your client's MCP tool timeout is short, the call is cut off before the result arrives. Set it to at least 120 seconds, or 660 seconds (11 minutes) if you use those tools. In Claude Code, add "timeout": 660000 (milliseconds) to the server entry or set MCP_TOOL_TIMEOUT=660000. For other clients, see their MCP settings. Do not resend the same request while waiting; raise the timeout and retry once.
대부분의 Tool은 2분 안에 끝나지만 음성 받아쓰기·긴 대화·그림 생성·등기 발급처럼 몇 분이 걸리는 Tool도 있습니다. 클라이언트의 MCP 도구 대기 시간이 짧으면 결과가 오기 전에 호출이 끊기므로 최소 120초, 이런 Tool을 쓴다면 660초(11분) 이상으로 두세요. Claude Code는 서버 설정 항목에 "timeout": 660000(밀리초)을 넣거나 MCP_TOOL_TIMEOUT=660000으로 늘립니다. 다른 도구는 각 도구의 MCP 설정 안내를 확인하세요. 기다리는 동안 같은 요청을 거듭 보내지 말고, 대기 시간을 늘린 뒤 한 번만 다시 보내세요.
3. Ask / 물어보기
사업자번호 439-87-00761 정상 사업자인지 확인하고 회사 정보 정리해줘
Check whether Korean business number 439-87-00761 is active and summarize the company
The agent picks biz_detail, calls it, and reads back the result.
AI가 알맞은 Tool(biz_detail)을 골라 호출하고 결과를 정리해 줍니다.
Servers / 서버 목록
Connect to all for everything, or to one server to keep the tool list short and the agent's choices focused.
전부 쓰려면 all, 특정 분야만 쓰려면 해당 서버에 연결하면 Tool 목록이 짧아져 AI가 더 정확히 고릅니다.
| Server 서버 | Endpoint | Tools | Coverage 범위 |
|---|---|---|---|
| All 통합 | https://apick.app/mcp/all |
222 | 아래 전부 + find_tools |
| Business 사업자·커머스 | https://apick.app/mcp/business |
81 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래·입찰 분석, 건축물대장, 차량 이력·리콜·하이패스 미납·자동차세, 간편인증 데이터 조회·세무 증빙서류 발급, 이메일 위험 일괄 검사, 유효성 검사 |
| Identity 신분증 | https://apick.app/mcp/identity |
16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
| Convert 파일변환 | https://apick.app/mcp/convert |
57 | PDF·DOCX·엑셀 변환, 서식 문서 작성·묶음·AI 채우기, STT, 비동기 TTS, 워터마크 |
| Web 웹·검색 | https://apick.app/mcp/web |
35 | 도메인·IP·WHOIS, 웹페이지 조회, URL→Markdown 변환, 페이지 캡처·텍스트 좌표, 구글 검색(웹·이미지·뉴스·쇼핑·지도·장소 상세·순위), 유튜브(검색·채널·댓글·자막·영상 정보), 인스타그램·X(프로필·게시물), 아마존·쿠팡 상품, 링크드인(회사·채용공고) |
| Vision 이미지·영상 | https://apick.app/mcp/vision |
6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
| OCR 문자인식 | https://apick.app/mcp/ocr |
6 | 이미지 텍스트 추출, 신분증 항목 추출 |
| AI · LLM | https://apick.app/mcp/ai |
15 | LLM 챗, 텍스트 요약·교정, 이미지 생성·편집·대량 작업, 비동기 영상 생성 |
| Finance 금융 | https://apick.app/mcp/finance |
5 | 계좌 예금주 조회, 1원 인증, 암호화폐 통합 시세·김치프리미엄, 월평균·연평균 환율 |
Every tool / 전체 Tool
→ TOOLS.md — the current 222-tool inventory and detailed examples for common tools. → TOOLS.md — 현재 222개 목록과 주요 도구의 파라미터·타입·호출 예시를 정리했습니다.
Business biz_detail venture_biz_info bid_notice bid_award rtms_trade rtms_rent land_rt_price land_info bldrgst court_auction registry_doc_verify req_pccc get_pccc get_car_flooding get_car_scrap parcel_tracking parcel_tracking_auto check_email_valid check_phone_valid check_spam_number holiday_info search_juso info app_reviews req_cash_receipt_deduction get_cash_receipt_deduction req_tax_return_history get_tax_return_history req_employment get_employment req_personal_income get_personal_income req_nps_join_history get_nps_join_history req_nps_deduction_cert get_nps_deduction_cert req_nps_career_history get_nps_career_history req_driving_license get_driving_license req_health_checkup get_health_checkup req_income_cert_bundle get_income_cert_bundle req_business_cert_bundle get_business_cert_bundle req_nps_bundle get_nps_bundle req_hometax_bundle get_hometax_bundle req_hometax_biz_bundle get_hometax_biz_bundle geo_site_score geo_address_cleanup email_risk_batch
Identity identi_card1 identi_card2 identi_card3 identi_card4 identi_card5 identi_card_image1 identi_card_image2 identi_card_image3 identi_card_image4 identi_card_image5 name_rrn_auth hide_rrn identity_document_residence_card identity_document_passport identity_document_id_card identity_document_driver_license
OCR ocr ocr_identi1 ocr_identi2 ocr_identi3 ocr_identi4 ocr_identi5
Finance transfer_1won account_realname bank_code crypto_market exchange_rate
Web nslookup reverse_ip location ip_history whois url_html url_screenshot url_similarity google_search google_image_search google_lens_search crawl_youtube youtube_metadata youtube_thumbnail youtube_subtitle_list youtube_subtitle youtube_search youtube_channel youtube_playlist youtube_hashtag youtube_comments google_news_search google_shopping_search google_maps_search google_rank_check instagram_profile instagram_post coupang_product linkedin_company linkedin_job url_to_markdown web_capture_extract
Convert stt tts_jobs_create tts_gemini_create tts_gemini_voices tts_openai_create tts_openai_voices tts_options tts_quote tts_jobs_status tts_jobs_cancel tts_jobs_result tts_jobs_subtitles voice_change face_blur pdf_to_docx pdf_to_image pdf_merge html_to_pdf docx_to_pdf json_to_excel base64_to_image set_watermark get_watermark draw_watermark_pdf draw_watermark_image
Vision nsfw_detection image_similarity video_to_mp3 extract_video_thumbnail word_cloud face_detection
AI llm_models llm_chat text_summary text_polish image_generate image_edit image_batch_create image_batch_status image_batch_result seedance_jobs_create seedance_jobs_status veo_jobs_create veo_jobs_status kling_jobs_create kling_jobs_status
All only 통합 서버 전용 find_tools
document_create · document_list · document_get · document_update · document_delete · document_ai_write · document_quote · document_download · document_quota · document_template · document_templates · document_assist · document_review · document_attachment_list · document_attachment_add · document_attachment_remove · document_download_bundle · document_download_pdf · document_workflow_quote · document_workflow_start · document_workflow_get · document_workflow_answer · document_workflow_apply · document_workflow_cancel · document_verify · document_finalize
Find the right tool / 알맞은 Tool 찾기 — find_tools
EN — The all server has 222 tools. find_tools recommends the best-matching APICK tools for a task described in natural language (Korean or English). It returns each tool's name, title, description and a relevance label (high, medium, low). It is free, works without an API key, and is available on the all server only; domain servers are small enough to choose from tools/list directly.
KO — all 서버에는 Tool이 222개 있습니다. find_tools는 자연어(한국어·영어)로 설명한 작업에 가장 알맞은 에이픽 Tool을 추천하고, Tool 이름·제목·설명과 관련도(high·medium·low)를 돌려줍니다. 무료이며 인증키 없이 호출할 수 있고, all 서버에서만 제공합니다. 분야별 서버는 Tool 수가 적어 tools/list만으로 고를 수 있습니다.
| Parameter | Type | Required | Description 설명 |
|---|---|---|---|
task |
string |
required 필수 | Task to perform, 2–500 characters · 하려는 작업 설명 (2~500자) |
limit |
integer |
optional 선택 | Number of tools to return, 1–10 (default 5) · 돌려받을 Tool 수 (1~10, 기본 5) |
curl -X POST "https://apick.app/mcp/all" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_tools","arguments":{"task":"사업자등록번호로 폐업 여부 확인","limit":3}}}'
Response structuredContent / 응답 structuredContent:
{"task":"사업자등록번호로 폐업 여부 확인","tools":[{"name":"biz_detail","title":"사업자 정보 조회","description":"Look up general status information of a Korean business ...","relevance":"high"}]}
If nothing fits, tools is empty and a message asks you to describe the task more specifically. Call the recommended tool with your API key as usual.
맞는 Tool이 없으면 tools가 빈 배열이고 작업을 더 구체적으로 적어 달라는 message가 포함됩니다. 추천받은 Tool은 평소처럼 인증키로 호출하세요.
Use cases / 주요 활용 사례
1. B2B onboarding & KYB — 거래처 실사 자동화
"거래처 사업자번호 목록 검증하고, 폐업이나 휴업 있으면 표로 정리해줘" "Validate this list of Korean business numbers and flag any that are closed or suspended"
biz_detail → venture_biz_info → check_email_valid · check_phone_valid
Pull registry status, representative, industry code and address for each business number, cross-check the contact email and phone, and get one table back. Replaces manual one-by-one lookups. 사업자번호마다 사업자 상태·대표자·업종·주소를 끌어오고 담당자 이메일·전화 유효성까지 교차검증해 표 하나로 받습니다.
2. Identity verification pipeline — 비대면 신원확인
"이 신분증 이미지 진위확인하고 주민번호 뒷자리 마스킹한 사본 만들어줘" "Verify this ID document image and produce a copy with the registration number masked"
identi_card_image1 → ocr_identi1 → identity_document_id_card
Checks the document against the government registry, extracts the fields, then returns a masked image safe to store. Covers 주민등록증 · 운전면허증 · 여권 · 외국인등록증 · 주민등록등본. 정부 registry 대조로 진위를 확인하고, 항목을 추출한 뒤, 보관 가능한 마스킹 사본까지 한 번에 만듭니다.
identity_document_residence_card는 외국인등록증·영주증·외국국적동포 국내거소신고증의 개인정보 마스킹을 지원합니다. 영주증과 외국국적동포 국내거소신고증은 마스킹만 지원하며 외국인등록증 진위확인 Tool의 범위에는 포함되지 않습니다.
identity_document_residence_card masks residence cards, permanent resident cards, and overseas Korean resident cards. The latter two are masking-only and are not accepted by the alien registration card authenticity-check tools.
3. Logistics & CS automation — 배송 문의 자동응답
"운송장 123456789012 지금 어디야? 지연되면 고객 안내문도 써줘" "Where is tracking number 123456789012? Draft a customer notice if it's delayed"
parcel_tracking_auto → text_polish
Auto-detects the carrier from the number alone across 33 Korean carriers (CJ대한통운, 한진, 롯데, 우체국, 로젠, 쿠팡로지스틱스 …), then drafts the customer message. 운송장 번호만으로 33개 택배사를 자동 판별해 조회하고, 고객 안내문 초안까지 씁니다.
4. Document processing — 문서 파이프라인
"이 PDF들 하나로 합치고 워터마크 넣은 다음 DOCX로도 뽑아줘" "Merge these PDFs, add a watermark, and also give me a DOCX"
pdf_merge → draw_watermark_pdf → pdf_to_docx
Also: html_to_pdf for invoices and reports, json_to_excel for data exports, and stt for speech recognition.
견적서·리포트는 html_to_pdf, 데이터 내보내기는 json_to_excel, 음성 인식은 stt를 사용합니다.
5. Domain & fraud investigation — 도메인·사기 조사
"이 사이트 IP, 위치, WHOIS 조사하고 우리 사이트랑 얼마나 비슷한지 봐줘" "Investigate this site's IP, location and WHOIS, and compare it to ours"
nslookup → location → whois → ip_history → url_similarity → url_screenshot
Built for phishing and copycat-site investigation: resolve the host, trace its IP history, score how closely it clones your page, and capture a screenshot as evidence. 피싱·모방 사이트 조사용입니다. 호스트를 확인하고 IP 이력을 추적한 뒤, 우리 페이지와의 유사도를 점수화하고 증거용 스크린샷까지 남깁니다.
6. Content safety & media — 콘텐츠 검수
"업로드된 이미지 중 유해한 거 걸러내고 사람 얼굴은 블러 처리해줘" "Filter unsafe uploads and blur any faces"
nsfw_detection → face_detection → face_blur
7. Payout & account verification — 정산 계좌 검증
"정산 대상 계좌 예금주가 등록된 이름과 같은지 확인해줘" "Check that the payout account holder matches the registered name"
bank_code → account_realname → transfer_1won
account_realname reads the holder name; transfer_1won proves ownership by depositing 1 KRW with a code in the memo.
account_realname은 예금주명을 읽고, transfer_1won은 적요에 인증코드를 담아 1원을 입금해 실소유를 증명합니다.
8. AI video generation — AI 영상 생성
"제품 사진으로 4초짜리 짧은 홍보 영상 만들어줘" "Turn this product photo into a short 4-second promo video"
veo_jobs_create → veo_jobs_status
Video generation (seedance_jobs_create, veo_jobs_create, kling_jobs_create) is asynchronous — submit a job, poll status, then download once it's completed via the status result's result_url. Billed per second (duration × per-second points), refunded in full on failure or timeout.
영상 생성(seedance_jobs_create, veo_jobs_create, kling_jobs_create)은 비동기입니다 — 접수 후 상태를 조회하다가 completed가 되면 상태 결과의 result_url로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.
Seedance 참조 소재 모드는 지원 버전에서 참조 이미지·영상·오디오(MP3·WAV) URL을 함께 받을 수 있습니다.
How it works / 동작 방식
| EN | KO | |
|---|---|---|
| Transport | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
| Protocol | MCP 2026-07-28, auto-compatible with earlier client versions |
MCP 2026-07-28 기본, 이전 규격 클라이언트 자동 호환 |
| Discovery | tools/list returns every tool with JSON Schema, description and live price — no key needed |
tools/list가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
| Annotations | Every tool declares title, readOnlyHint, openWorldHint. 62 of 222 are not read-only |
전 Tool이 title·readOnlyHint·openWorldHint 선언. 222개 중 상태 변경 Tool은 62개 |
| Results | Text (JSON) + structuredContent. Images as image content; files up to 8MB as base64 |
텍스트(JSON)와 structuredContent 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
| File input | File-taking tools accept a public https URL (image_url, pdf_url, …) — APICK downloads and processes it |
파일 Tool은 공개 https URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
| Errors | Delivered via isError; identity masking also preserves structuredContent.error_code |
isError로 전달되며 신분증 마스킹은 structuredContent.error_code도 보존합니다 |
| Auth | Authorization: Bearer <key>; X-API-Key also accepted |
Authorization: Bearer 인증키, X-API-Key도 지원 |
간편인증 데이터 조회 / Simple-auth data lookups
Business 또는 All 서버에서 접수 Tool을 호출하고, 사용자가 휴대폰에서 승인한 뒤 같은 상품의 결과 Tool에 transactionId를 전달합니다. 접수는 알림 발송·과금을 동반하므로 사용자 확인 후 실행하며 승인 대기 중 자동으로 재접수하지 않습니다.
Call the request tool on Business or All, ask the user to approve on their phone, then pass transactionId to the matching result tool. Request calls send a notification and incur a charge; obtain confirmation and do not repeatedly submit while waiting.
| 기능 | SDK 메서드 | MCP Tool |
|---|---|---|
| 재직·보험료 확인 | requestEmployment / getEmployment |
req_employment / get_employment |
| 금융소득(이자·배당) 조회 | requestPersonalIncome / getPersonalIncome |
req_personal_income / get_personal_income |
| 국민연금 가입내역 | requestNpsJoinHistory / getNpsJoinHistory |
req_nps_join_history / get_nps_join_history |
| 국민연금 소득공제용 납부확인서 | requestNpsDeductionCert / getNpsDeductionCert |
req_nps_deduction_cert / get_nps_deduction_cert |
| 국민연금 경력 이력 | requestNpsCareerHistory / getNpsCareerHistory |
req_nps_career_history / get_nps_career_history |
| 운전면허 조회 | requestDrivingLicense / getDrivingLicense |
req_driving_license / get_driving_license |
| 국가 건강검진 결과 | requestHealthCheckup / getHealthCheckup |
req_health_checkup / get_health_checkup |
| 현금영수증 소득공제 내역 | requestCashReceiptDeduction / getCashReceiptDeduction |
req_cash_receipt_deduction / get_cash_receipt_deduction |
| 국세 신고내역 조회 | requestTaxReturnHistory / getTaxReturnHistory |
req_tax_return_history / get_tax_return_history |
| 소득 증빙서류 통합발급 (소득금액증명·연금보험료등 소득세액 공제확인서) | requestIncomeCertBundle / getIncomeCertBundle |
req_income_cert_bundle / get_income_cert_bundle |
| 사업자 증빙서류 통합발급 (사업자등록증명·부가가치세 과세표준증명·표준재무제표증명) | requestBusinessCertBundle / getBusinessCertBundle |
req_business_cert_bundle / get_business_cert_bundle |
| 국민연금 통합조회 (가입내역·소득공제용 납부확인서·경력이력) | requestNpsBundle / getNpsBundle |
req_nps_bundle / get_nps_bundle |
| 개인 국세 통합조회 (소득·신고·납부·증명 중 고른 조회) | requestHometaxBundle / getHometaxBundle |
req_hometax_bundle / get_hometax_bundle |
| 사업자 국세 통합조회 (매출·매입·증명·전자세금계산서 중 고른 조회) | requestHometaxBizBundle / getHometaxBizBundle |
req_hometax_biz_bundle / get_hometax_biz_bundle |
공통 입력은 SDK와 같은 name, birthDate(YYYYMMDD), phone, authProvider입니다. 상품별 기간 옵션과 응답 상태·오류는 Tool 계약을 확인하세요. 최초 결과 반환 시 조회 범위에 따라 과금하며, 대기 중 조회와 유효기간 내 재조회는 무료입니다.
Common inputs match the SDK: name, birthDate, phone, and authProvider. The first result delivery is billed by query scope; waiting polls and repeat reads within the result lifetime are free. See the tool contract for options and response fields.
증빙서류 묶음: 승인 한 번으로 증명 여러 장을 발급합니다. 공통 입력에 더해 year·use_purpose·submit_to·delivery가 필요하고, 사업자 묶음은 business_no와 대표자 확인(agreed: true 또는 이전 응답의 bind_id)이 필요합니다. 결과는 증명마다 섹션이 따로 오며, 대화형 사용은 format: "json"으로 PDF 원본 없이 받는 것을 권장합니다. 최초 결과는 소득 묶음 84P, 사업자 묶음 126P입니다. 자세한 입력은 발급 입력을 확인하세요.
Certificate bundles: one approval issues several certificates. Besides the common inputs they need year, use_purpose, submit_to and delivery; the business bundle also needs business_no and representative consent (agreed: true or a previous bind_id). Each certificate has its own result section; use format: "json" in chat clients to skip the PDF payload. First result: 84P (income) and 126P (business).
통합 조회 묶음: 승인 한 번으로 여러 조회를 처리합니다. req_nps_bundle은 국민연금 3종을 항상 함께 조회하고, req_hometax_bundle·req_hometax_biz_bundle은 products로 고른 조회만 실행합니다. 과금은 고른 상품 단가의 합(국민연금은 묶음 126P)이고 모두 실패하면 과금되지 않습니다. 사업자 묶음은 business_no와 대표자 확인(agreed: true 또는 이전 응답의 bind_id)이 필요합니다. 고를 수 있는 키는 TOOLS.md에 있습니다.
Lookup bundles: one approval runs several lookups. req_nps_bundle always runs the three pension lookups; req_hometax_bundle and req_hometax_biz_bundle run only the products named in products. Billing is the sum of the selected products (126P fixed for the pension bundle) and nothing is charged when every lookup fails. The business bundle also needs business_no and representative consent (agreed: true or a previous bind_id).
PCCC 비교: 승인 흐름은 같지만 req_pccc는 birthday·provider, get_pccc는 tx_id를 사용하며 결과 재조회도 과금됩니다. 간편인증 데이터 조회 11개 상품의 입력 이름이나 무료 재조회 정책을 PCCC에 적용하지 마세요.
PCCC comparison: The approval flow is the same, but PCCC retains birthday/provider and tx_id, and charges for repeated result reads. Its contract is unchanged.
Вопросы о APICK MCP
Как добавить APICK MCP в Claude Code?
Выполните claude mcp add --transport http ocr https://apick.app/mcp/ocr в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить APICK MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет APICK MCP?
Он предоставляет 39 инструментов, включая task, limit, req_employment, get_employment, req_personal_income.
Нужен ли мне API key, чтобы увидеть доступные инструменты?
Нет, команда tools/list работает без ключа, что позволяет клиентам изучить все 222 инструмента перед регистрацией.
Что делать, если вызов инструмента прерывается по таймауту?
Некоторые инструменты, такие как генерация изображений или выдача документов, занимают несколько минут; вам следует увеличить таймаут MCP в вашем клиенте как минимум до 120 секунд, а для определенных ресурсоемких задач — до 660 секунд.