개발가이드시작하기MCP 연동 (AI 에이전트)

MCP 연동 (AI 에이전트)

AI 도구에 서버 주소와 인증키만 등록하면 사업자 조회·택배 배송조회·OCR·파일 변환 등 에이픽 223개 기능을 AI가 대화 중에 직접 호출합니다. 연동 코드 없이 바로 쓰고, 요금은 REST API와 같아 쓴 만큼만 차감됩니다.

개요·제공 범위

Claude · Cursor · VS Code · Windsurf에서 바로

코드 한 줄 없이,
AI가 223개 API를 직접 씁니다.

서버 주소와 인증키를 한 번 등록하면 끝입니다. “이 사업자 정상인지 보고 엑셀로 정리해 줘”라고 말하면 AI가 알맞은 기능을 골라 호출하고 결과까지 정리합니다. 연동 개발 기간은 0일, 요금은 REST API와 똑같이 쓴 만큼만.

  • 223개AI가 바로 쓰는 기능
  • 9개기능군별 서버 + 통합 서버
  • 공식 등록MCP Registry app.apick/*
  • 실패 무과금성공한 호출만 차감

왜 에이픽 MCP인가요?

연동 개발이 사라집니다

API 문서를 읽고 요청 코드를 짜고 오류를 처리하던 일을 AI가 대신합니다. 등록 한 번이면 모든 기능이 대화 속으로 들어옵니다.

여러 기능을 알아서 엮습니다

조회 → 정리 → 파일 변환처럼 몇 단계가 필요한 일도 AI가 순서대로 호출합니다. 파이프라인 코드를 따로 쓰지 않아도 됩니다.

새 기능은 자동으로 따라옵니다

에이픽에 기능이 추가되면 AI가 연결 직후 목록을 다시 읽어 바로 씁니다. 다시 배포할 것이 없습니다.

계약도 지갑도 하나

기능마다 업체를 찾아 가입·계약할 필요가 없습니다. 인증키 하나, 포인트 지갑 하나로 223개 기능을 씁니다.

직접 연동과 비교하면

구분
기능마다 직접 연동
에이픽 MCP
시작까지
문서 읽고 코드 작성·시험·배포
주소와 키 등록, 몇 분
기능 추가
기능마다 다시 개발
AI가 자동으로 발견
여러 기능 조합
호출 순서·데이터 변환 코드 작성
말로 요청하면 AI가 조합
계정·결제
업체마다 가입·계약·충전
인증키 하나, 지갑 하나
실패한 호출
업체마다 과금 기준이 다름
과금 없음

말 한마디로 끝나는 일들

실제로 많이 쓰는 요청입니다. 괄호 안은 AI가 골라 쓰는 Tool입니다.

영업·구매

“거래처 사업자번호 목록, 휴폐업 걸러서 엑셀로 줘”

biz_detail → json_to_excel
쇼핑몰 CS

“오늘 문의 들어온 송장들 지금 어디쯤인지 정리해 줘”

parcel_tracking_auto
마케팅

“우리 키워드 검색 순위랑 경쟁 상품 가격 비교해 줘”

google_rank_check → google_shopping_search
부동산

“이 주소 최근 실거래가랑 건축물 현황 요약해 줘”

search_juso → rtms_trade → bldrgst
콘텐츠 제작

“이 대본으로 내레이션 만들고 썸네일 이미지도 뽑아 줘”

tts_jobs_create → image_generate
문서 업무

“계약서 PDF 세 개 합치고 대외비 워터마크 넣어 줘”

pdf_merge → draw_watermark_pdf

3단계로 시작

  1. 1
    가입

    회원가입하면 무료 1,000포인트가 바로 들어옵니다.

  2. 2
    인증키 확인

    마이페이지에서 인증키를 복사합니다.

  3. 3
    AI 도구에 등록

    아래 클라이언트별 연결 방법의 명령을 붙여 넣고 “에이픽으로 사업자번호 조회해 줘”라고 말해 보세요.

서버와 제공 기능

기능군별 서버 8개와 전체 통합 서버 1개를 제공합니다. 필요한 기능군만 연결하면 AI의 도구 선택이 더 정확해지고, 전부 필요하면 통합 서버 하나로 충분합니다. 에이픽 MCP 서버는 공식 MCP Registry에 app.apick/* 이름으로 등록되어 있습니다.

전체 통합 서버
URL
APICK 전체 (223개 Tool)
https://apick.app/mcp/all
APICK Finance — 계좌 실명조회·1원 인증 등 대한민국 금융 확인 API (4개)
https://apick.app/mcp/finance
Tool
기능
이용 요금(P)
transfer_1won
1원 인증
60
account_realname
계좌 예금주 실명 조회
60
bank_code
은행코드 조회
무료
crypto_market
암호화폐 통합 시세·김치프리미엄
30
APICK Identity — 신분증 진위확인·실명확인·개인정보 마스킹 API (16개)
https://apick.app/mcp/identity
Tool
기능
이용 요금(P)
identi_card1
[Text] 주민등록증 진위 확인
40
identi_card2
[Text] 운전면허증 진위 확인
40
identi_card3
[Text] 여권 진위 확인
40
identi_card4
[Text] 주민등록등본 진위 확인
40
identi_card5
[Text] 외국인등록증 진위 확인
40
identi_card_image1 📎
[Image/PDF] 주민등록증 진위 확인
60
identi_card_image2 📎
[Image/PDF] 운전면허증 진위 확인
60
identi_card_image3 📎
[Image/PDF] 여권 진위 확인
60
identi_card_image4 📎
[Image/PDF] 주민등록등본 진위 확인
60
identi_card_image5 📎
[Image/PDF] 외국인등록증 진위 확인
60
name_rrn_auth
성명/주민등록번호 실명확인
50
hide_rrn 📎
개인정보 마스킹(주민등록번호)
20
identity_document_residence_card 📎
외국인등록증 개인정보 마스킹
30
identity_document_passport 📎
여권 개인정보 마스킹
30
identity_document_id_card 📎
주민등록증 개인정보 마스킹
30
identity_document_driver_license 📎
운전면허증 개인정보 마스킹
30
APICK OCR — 이미지 텍스트 추출·신분증 OCR API (6개)
https://apick.app/mcp/ocr
Tool
기능
이용 요금(P)
ocr 📎
이미지 텍스트 추출(OCR)
12
ocr_identi1 📎
주민등록증 텍스트 추출(OCR)
12
ocr_identi2 📎
운전면허증 텍스트 추출(OCR)
12
ocr_identi3 📎
여권 텍스트 추출(OCR)
12
ocr_identi4 📎
주민등록등본 텍스트 추출(OCR)
12
ocr_identi5 📎
외국인등록증 텍스트 추출(OCR)
12
APICK Business — 사업자·기업정보·택배·간편인증 기반 개인 데이터 조회 API (81개)
https://apick.app/mcp/business
Tool
기능
이용 요금(P)
biz_detail
사업자 정보 조회
50
venture_biz_info
벤처기업 정보조회
40
land_rt_price
부동산 실거래가 조회
50
req_pccc
개인통관고유부호 인증 요청
20
get_pccc
개인통관고유부호 조회
20
get_car_flooding
차량 침수차 여부 조회
10
get_car_scrap
차량 폐차사고처리 여부 조회
10
vehicle_model_info
차종별 차량정보 조회
20
vehicle_emission
배출가스 인증정보 조회
60
vehicle_recall
자동차 리콜 대상 조회
60
hipass_unpaid
하이패스 미납 여부 조회
60
vehicle_tax_calc
자동차세 계산
60
parcel_tracking
택배 배송조회
5
parcel_tracking_auto
택배 배송조회(자동)
10
check_email_valid
이메일 유효성 검사
10
email_risk_batch
이메일 위험도 일괄 검사
20
check_phone_valid
전화번호 유효성 검사
40
check_spam_number
스팸/광고/범죄 전화번호 조회
10
holiday_info
공휴일 조회
3
search_juso
도로명주소 조회
2
info
계정 정보 조회
무료
bid_notice
입찰 기회 분석
50
bid_award
낙찰 경쟁 분석
50
dart_disclosure
공시 이벤트 분석
50
dart_company
기업 스냅샷
30
dart_financials
재무 건전성 분석
50
corp_finance
기업 재무정보
50
rtms_trade
매매 시장 분석
50
rtms_rent
전월세 시장 분석
50
land_info
토지 종합 분석
50
bldrgst
건축물대장 조회
30
court_auction
법원 경매 사건 조회
60
registry_doc_verify
등기·증명서 발급확인
60
app_reviews
앱 리뷰 조회
30
geo_standardize
주소 표준화·코드 변환
30
geo_batch_geocode
대량 주소 좌표 변환
40
geo_reverse
좌표→주소·행정구역
20
geo_address_search
주소 검색·정규화
20
geo_place_search
장소 검색·거리 정렬
20
geo_admin_code
행정구역 코드 조회
20
geo_compare_address
주소 동일성 판정
10
geo_measure
좌표 거리·면적 측량
10
geo_geojson_analyze
GeoJSON 면적·포함 분석
10
geo_address_quality
주소 품질 진단
30
geo_address_autocomplete
주소 자동완성
10
geo_district_boundary
행정구역 경계·면적 분석
20
geo_neighborhood
주변 생활시설 분석
40
geo_site_score
입지 종합 점수
50
geo_address_cleanup
주소록 중복·권역 정비
40
req_cash_receipt_deduction
현금영수증 소득공제 내역 인증 요청
20
get_cash_receipt_deduction
현금영수증 소득공제 내역 결과
60
req_tax_return_history
국세 신고내역 조회 인증 요청
20
get_tax_return_history
국세 신고내역 조회 결과
60
req_employment
재직·보험료 확인 인증 요청
20
get_employment
재직·보험료 확인 결과
120
req_personal_income
금융소득(이자·배당) 조회 인증 요청
20
get_personal_income
금융소득(이자·배당) 조회 결과
60
req_nps_join_history
국민연금 가입내역 조회 인증 요청
20
get_nps_join_history
국민연금 가입내역 조회 결과
60
req_nps_deduction_cert
국민연금 소득공제용 납부확인서 인증 요청
20
get_nps_deduction_cert
국민연금 소득공제용 납부확인서 결과
60
req_nps_career_history
국민연금 경력 이력 조회 인증 요청
20
get_nps_career_history
국민연금 경력 이력 조회 결과
60
req_driving_license
운전면허 조회 인증 요청
20
get_driving_license
운전면허 조회 결과
60
req_health_checkup
국가 건강검진 결과 조회 인증 요청
20
get_health_checkup
국가 건강검진 결과 조회 결과
60
req_income_cert_bundle
소득 증빙서류 통합발급 인증 요청
20
get_income_cert_bundle
소득 증빙서류 통합발급 결과
84
req_business_cert_bundle
사업자 증빙서류 통합발급 인증 요청
20
get_business_cert_bundle
사업자 증빙서류 통합발급 결과
126
req_nps_bundle
국민연금 통합조회 인증 요청
20
get_nps_bundle
국민연금 통합조회 결과
126
req_hometax_bundle
개인 국세 통합조회 인증 요청
20
get_hometax_bundle
개인 국세 통합조회 결과
720
req_hometax_biz_bundle
사업자 국세 통합조회 인증 요청
20
get_hometax_biz_bundle
사업자 국세 통합조회 결과
900
registry_realestate_search
부동산 등기 검색
40
registry_corporate_search
법인 등기 검색
40
registry_realestate_jobs_create
부동산 등기 열람·발급
850
registry_corporate_jobs_create
법인 등기 열람·발급
850
APICK Web — 도메인·IP 조회, 웹페이지 조회, 검색 API (38개)
https://apick.app/mcp/web
Tool
기능
이용 요금(P)
nslookup
도메인으로 IP 조회
1
reverse_ip
IP로 도메인 조회
100
location
도메인/IP 위치 조회
30
ip_history
IP 변경 이력 조회
100
whois
WHOIS 조회
100
url_html
URL HTML 추출
5
url_screenshot
URL 화면캡처
5
url_similarity
URL 유사도 비교
5
google_search
구글 키워드 검색
7
google_image_search
구글 이미지 검색(키워드로 검색)
40
google_news_search
구글 뉴스 검색
7
google_shopping_search
구글 쇼핑 검색
7
google_maps_search
구글 지도 장소 검색
15
google_rank_check
구글 검색 순위 확인
70
google_lens_search 📎
구글 렌즈 검색(이미지로 검색)
60
crawl_youtube
유튜브 계정 정보 조회
40
youtube_search
유튜브 검색
20
youtube_playlist
유튜브 재생목록 조회
20
youtube_channel
유튜브 채널 조회
20
youtube_hashtag
유튜브 해시태그 영상 조회
20
youtube_comments
유튜브 댓글 조회
30
youtube_metadata
유튜브 영상 정보 조회
20
youtube_thumbnail
유튜브 썸네일 다운로드
20
youtube_subtitle_list
유튜브 자막 목록 조회
20
youtube_subtitle
유튜브 자막 다운로드
30
instagram_profile
인스타그램 프로필 조회
20
instagram_post
인스타그램 게시물·릴스 조회
10
tiktok_profile
틱톡 프로필 조회
20
amazon_product
아마존 상품 정보 조회
20
x_profile
X 프로필 조회
20
x_post
X 게시물 조회
10
coupang_product
쿠팡 상품 조회
30
naver_shopping_product
네이버 브랜드스토어 상품 조회
30
linkedin_profile
링크드인 프로필 조회
30
linkedin_company
링크드인 회사 조회
30
linkedin_job
링크드인 채용공고 조회
30
url_to_markdown
URL을 Markdown·JSON으로 변환
15
web_capture_extract
웹페이지 캡처+텍스트 좌표
20
APICK Convert — 문서·음성·이미지 파일 변환과 워터마크 API (57개)
https://apick.app/mcp/convert
Tool
기능
이용 요금(P)
stt 📎
오디오 텍스트 변환(STT)
50
tts_jobs_create
TTS 작업 접수
무료
tts_gemini_create
Gemini TTS 작업 접수
무료
tts_gemini_voices
Gemini TTS 목소리 목록
무료
tts_openai_create
ChatGPT TTS 작업 접수
무료
tts_openai_voices
ChatGPT TTS 목소리 목록
무료
tts_options
TTS 표현·화자 옵션
무료
tts_quote
TTS 예상 요금
무료
tts_jobs_status
TTS 작업 상태 조회
무료
tts_jobs_cancel
TTS 작업 취소
무료
tts_jobs_result
TTS MP3 결과 다운로드
무료
tts_jobs_subtitles
TTS ASS 자막 다운로드
무료
voice_change 📎
음성 변조
10
face_blur 📎
얼굴 모자이크 처리
20
pdf_to_docx 📎
PDF 파일 DOCX 변환
30
pdf_to_image 📎
PDF 파일 이미지 변환
2
pdf_merge 📎
PDF 파일 합치기
2
html_to_pdf
HTML PDF 변환
30
docx_to_pdf 📎
DOCX 파일을 PDF 파일로 변환
80
json_to_excel
JSON 데이터 EXCEL 파일 변환
1
base64_to_image
base64 이미지 변환
2
set_watermark 📎
비가시성 워터마크 삽입
10
get_watermark 📎
비가시성 워터마크 조회
10
draw_watermark_pdf 📎
PDF 워터마크 삽입
10
draw_watermark_image 📎
Image 워터마크 삽입
10
form_document
서식 자동작성
100
form_list
서식 목록
100
form_fields
서식 필드 정의
100
form_preview
서식 인식 미리보기
100
form_bundle
서식 묶음 ZIP
100
form_ai_fill
서식 AI 채우기
20
document_create
문서 만들기
무료
document_list
내 문서 목록
무료
document_get
내 문서 열기
무료
document_update
문서 수정
무료
document_delete
문서 삭제
무료
document_ai_write
AI 문서 작성
20
document_quote
문서 다운로드 견적
무료
document_download
문서 DOCX 다운로드
100
document_quota
문서 AI 이용 기준
무료
document_template
서식·판본 불러오기
무료
document_templates
핵심 문서 작성 기준
무료
document_assist
문서 작성 보조
20
document_review
문서 검토
20
document_attachment_list
문서 첨부 목록
무료
document_attachment_add
문서 첨부 추가
무료
document_attachment_remove
문서 첨부 삭제
무료
document_download_bundle
문서·첨부 ZIP 다운로드
100
document_download_pdf
문서 PDF 다운로드
100
document_workflow_quote
문서 작성 단계 견적
무료
document_workflow_start
대화 문서 작성 시작
무료
document_workflow_get
문서 작성 상태
무료
document_workflow_answer
문서 작성 추가 답변
무료
document_workflow_apply
문서 초안 저장
무료
document_workflow_cancel
문서 작성 취소
무료
document_verify
문서 자료·규칙 검증
무료
document_finalize
문서 완성본 확정
무료
APICK Vision — 이미지·영상 분석과 물체 인식 API (6개)
https://apick.app/mcp/vision
Tool
기능
이용 요금(P)
nsfw_detection 📎
선정적인 컨텐츠(NSFW) 탐지
10
image_similarity 📎
이미지 유사도 비교
10
video_to_mp3 📎
동영상 MP3 추출
30
extract_video_thumbnail 📎
동영상 미리보기 이미지 추출
10
word_cloud
워드클라우드 생성
10
face_detection 📎
이미지 얼굴 인식
3
APICK AI — LLM 챗·텍스트 도구·이미지 생성과 편집·영상 생성 API (15개)
https://apick.app/mcp/ai
Tool
기능
이용 요금(P)
llm_models
LLM 모델 카탈로그
무료
llm_chat
LLM 채팅
5
text_summary
텍스트 요약 AI
100
text_polish
텍스트 다듬기 AI
100
image_generate 📎
이미지 한 장 생성
40
image_edit 📎
이미지 한 장 편집
40
image_batch_create 📎
이미지 대량 작업 생성
40
image_batch_status
이미지 대량 작업 상태
40
image_batch_result
이미지 대량 작업 결과
40
seedance_jobs_create 📎
Seedance 영상 작업 접수
1250
seedance_jobs_status
Seedance 영상 작업 상태
1250
veo_jobs_create 📎
Veo 영상 작업 접수
900
veo_jobs_status
Veo 영상 작업 상태
900
kling_jobs_create 📎
Kling 영상 작업 접수
410
kling_jobs_status
Kling 영상 작업 상태
410

📎 표시는 파일 입력 Tool입니다(아래 파일 입력 방식 참고). 요금은 API 목록의 REST 요금과 동일합니다.

연동 방식 (기술 상세)

항목
내용
전송 방식
Streamable HTTP — 서버당 단일 엔드포인트에 HTTPS POST로 JSON-RPC 2.0 메시지를 보냅니다. 별도 세션·핸드셰이크 없이 요청 단위로 동작합니다(stateless).
프로토콜 버전
MCP 2026-07-28 기본, 이전 규격(2025-06-18 등) 클라이언트도 자동 호환. 클라이언트가 보내는 버전을 서버가 감지해 맞춰 응답합니다.
기능 발견
tools/list — 사용 가능한 Tool 목록과 각 Tool의 입력 스키마(JSON Schema)·설명·요금을 반환합니다. 인증 없이 호출할 수 있어 연결 직후 AI가 기능을 파악합니다.
기능 실행
tools/call — Tool 이름과 인자를 보내면 실행 결과를 반환합니다. 성공 시 구조화된 JSON 데이터와 함께 응답 메타데이터(차감 포인트·처리 시간·결제 로그 ID)가 담깁니다.
결과 형식
텍스트(JSON)와 구조화 데이터(structuredContent)를 함께 반환해 신·구 클라이언트 모두에서 동작합니다. 이미지 결과는 이미지 콘텐츠로, 파일 결과는 base64로 반환합니다.
오류 처리
업무 오류는 Tool 결과의 오류 플래그(isError)로 전달되어 AI가 원인을 읽고 대처합니다. 실패한 호출은 과금되지 않습니다.
호출 예시 — Tool 목록 조회 (인증 불필요)

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":{}}'
            
호출 예시 — 택배 배송조회 Tool 실행

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 도구의 서버 설정에 아래 헤더 중 하나를 넣으면 매 호출에 자동으로 포함됩니다.

헤더
형식
비고
Authorization
Bearer 인증키
권장 — 대부분의 MCP 클라이언트가 기본 지원
X-API-Key
인증키
Bearer 형식을 지원하지 않는 도구용
인증 규칙
내용
무인증 허용 범위
서버 연결, Tool 목록·설명 조회(tools/list)까지. Tool 실행(tools/call)부터 인증키가 필요합니다.
키가 없거나 틀리면
실행 결과로 안내 메시지가 반환됩니다. AI가 이 메시지를 읽고 사용자에게 키 설정을 안내합니다.
허용 IP 제한
마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 한 줄에 하나씩 입력하세요. 단일 IP와 CIDR(220.88.184.134/32 등)을 지원하며 저장 즉시 반영됩니다.
키 보안
인증키는 비밀번호와 같습니다. 공개 저장소·화면 공유·대화 로그에 노출하지 말고, 노출이 의심되면 마이페이지에서 즉시 재발급하세요(기존 키는 바로 무효화됩니다).

클라이언트별 연결 방법

Claude Code (CLI)

claude mcp add --transport http apick https://apick.app/mcp/all \
  --header "Authorization: Bearer 인증키"
            
Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apick": {
      "type": "http",
      "url": "https://apick.app/mcp/all",
      "headers": {
        "Authorization": "Bearer 인증키"
      }
    }
  }
}
            
Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "apick": {
      "url": "https://apick.app/mcp/all",
      "headers": {
        "Authorization": "Bearer 인증키"
      }
    }
  }
}
            
Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "apick": {
      "serverUrl": "https://apick.app/mcp/all",
      "headers": {
        "Authorization": "Bearer 인증키"
      }
    }
  }
}
            
VS Code (.vscode/mcp.json)

{
  "servers": {
    "apick": {
      "type": "http",
      "url": "https://apick.app/mcp/all",
      "headers": {
        "Authorization": "Bearer 인증키"
      }
    }
  }
}
            

특정 기능군만 쓰려면 URL의 /mcp/all을 위 표의 그룹 URL(예: /mcp/business)로 바꾸면 됩니다.

도구 대기 시간 — 대부분의 Tool은 2분 안에 끝나지만 음성 받아쓰기·긴 대화·그림 생성·등기 발급처럼 몇 분이 걸리는 Tool도 있습니다. AI 도구의 MCP 대기 시간이 짧으면 결과가 오기 전에 호출이 끊기므로 최소 120초, 이런 Tool을 쓴다면 11분(660초) 이상으로 두세요. Claude Code는 서버 설정 항목에 "timeout": 660000(밀리초)을 넣거나 환경 변수 MCP_TOOL_TIMEOUT=660000으로 늘립니다. 다른 도구는 각 도구의 MCP 설정 안내를 확인하세요.

요금

MCP 호출 요금은 REST API와 동일하며, 같은 포인트 지갑에서 사용한 만큼만 차감됩니다. 월 구독료가 없고(상품별 호출당 기본요금은 각 가이드 참고) 실패한 호출은 과금되지 않습니다. 회원가입 시 무료 1,000포인트가 지급되어 바로 사용해 볼 수 있습니다.

자주 묻는 질문

질문
답변
"유효하지 않은 API키" 오류가 나요
마이페이지의 인증키를 다시 확인하세요. Authorization 헤더는 "Bearer " 접두사 뒤에 키를 붙입니다. 허용 IP를 설정한 계정이라면 호출 IP가 목록에 있어야 합니다.
"허용되지 않은 IP주소" 오류가 나요
마이페이지의 허용 IP를 공란으로 저장하면 제한이 해제됩니다. 제한을 유지하려면 MCP 요청이 APICK에 도착할 때의 공인 IPv4 또는 해당 CIDR을 등록하세요. 별도 동기화나 반영 대기시간은 없습니다.
Tool 호출이 1분쯤에서 끊겨요
AI 도구의 MCP 대기 시간이 짧아서입니다. 도구 대기 시간 안내대로 늘린 뒤 다시 시도하세요. 응답이 오기 전에 같은 요청을 거듭 보내지 말고, 대기 시간을 늘린 다음 한 번만 다시 보내세요.
"포인트가 부족합니다" 오류가 나요
충전 페이지에서 포인트를 충전하세요.
키 없이 어디까지 되나요?
서버 연결과 Tool 목록·설명 확인까지 가능합니다. Tool 실행부터 인증키가 필요하므로 tools/list 성공만으로는 키나 허용 IP가 검증되지 않습니다.
어떤 AI 도구를 지원하나요?
MCP Streamable HTTP를 지원하는 모든 클라이언트에서 사용할 수 있습니다. 최신 규격(2026-07-28)과 이전 규격(2025-06-18 등) 모두 자동 호환됩니다.
REST API와 뭐가 다른가요?
같은 기능·같은 요금입니다. 직접 연동 개발에는 REST를, AI 도구에서 바로 쓰려면 MCP를 선택하면 됩니다.

요청·연동

파일 입력 방식

OCR·파일 변환처럼 파일을 받는 Tool(📎)은 image_url / file_url 형태의 파라미터로 파일의 https 주소를 받습니다. 로그인 없이 누구나 열 수 있는 주소여야 하며, AI에게 그 주소를 알려 주면 됩니다. Tool별 허용 형식과 최대 크기는 각 Tool의 파라미터 설명에 표시됩니다. 결과가 파일인 경우 8MB까지 응답에 직접 담아 반환합니다.

연동 예제

활용 예시

연결 후 AI에게 이렇게 요청해 보세요. AI가 알맞은 에이픽 Tool을 골라 호출하고 결과를 정리해 줍니다.

요청 예시
사용되는 Tool
"사업자번호 123-45-67890 정상 사업자인지 확인하고 회사 정보 정리해줘"
biz_detail
"CJ대한통운 운송장 123456789012 지금 어디쯤이야?"
parcel_tracking
"이 영수증 이미지에서 텍스트 뽑아줘: https://…/receipt.jpg"
ocr
"example.com 도메인의 IP와 위치, WHOIS 정보 조사해줘"
nslookup, location, whois
"이 HTML을 PDF로 변환해줘"
html_to_pdf

개발가이드 검색

API 이름·경로·파라미터·오류 코드로 찾을 수 있습니다.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.