AI 연결
ERP 에 AI 를 넣은 것이 아니라, AI 가 읽을 수 있게 만들었습니다
볼테나는 제품 안에 AI 를 만들어 넣어 팔지 않습니다. 대신 고객이 이미 쓰는 AI(Claude·ChatGPT)가 그 회사 장부를 표준 방식으로 읽을 수 있게 열어 둡니다. 어느 AI 가 이길지 우리가 대신 고르지 않는 편이 고객에게 더 오래 맞습니다.
한눈에 보는 사실
| 연결 주소 | POST https://app.boltena.com/api/ext/mcp |
|---|---|
| 프로토콜 | MCP(Model Context Protocol) 2025-06-18 · JSON-RPC 2.0 over HTTP |
| 인증 | x-api-key 헤더 하나 — 관리자가 발급하며, 키가 회사를 정합니다(회사코드를 따로 보내지 않습니다) |
| 도구 | 조회 10종 — 현재고 · 월별 매출 · 미수채권 · 수주 미납 · 발주 미납 · 합계잔액시산표 · 자재부족 · 미수채권 연체구간 · 재고금액 · 자금일보 |
| 쓰기 | 제공하지 않습니다 — 입력·수정·삭제 도구가 없습니다 |
| 한 번에 읽는 양 | 최대 100행(기본 20행). 전체 건수와 총계는 함께 알려 줍니다 |
| 30일 체험 | 포함 — 카드 등록 없이 가입 즉시 연결해 볼 수 있습니다 |
| 체험 이후 | 연동(CONN) 모듈 계약이 필요합니다. 무료 플랜에는 포함되지 않습니다 |
| 스펙 | openapi.json — 키 없이 내려받습니다 |
| 키별 범위 | 발급할 때 그 키가 읽을 자료만 지정합니다(미지정이면 전체) — 범위 밖은 목록에도 없고 호출해도 거부됩니다 |
| 감사 | 어느 키가 언제 무엇을 읽었는지 기록에 남습니다(제품의 사용현황 화면) |
| 서버 메타데이터 | mcp-server.json — 기계용(주소·도구 목록·조회 전용 표기) |
조건을 여기 적어 두는 이유는 단순합니다 — 31일째에 기능이 사라지는 경험만큼 신뢰를 빨리 무너뜨리는 것이 없습니다.
이렇게 씁니다
담당자가 화면을 찾아 들어가지 않고, 늘 쓰던 대화창에서 묻습니다.
영업
"미수채권 큰 거래처 위에서 다섯 곳"
"납기 지난 수주 아직 안 나간 거 있나"
"90일 넘게 안 들어온 돈 있어?"
자재·생산
"재고 부족한 품목 뭐야?"
"아직 안 들어온 발주 정리해줘"
"이 품목 지금 재고 몇 개야"
경영·회계
"지난달 매출 얼마였지"
"이번 달 자금 들어오고 나간 거 요약해줘"
"시산표에서 이상한 계정 있어?"
위 질문은 전부 실제 도구에 1:1 로 대응합니다 — 도구가 없는 질문을 예시로 싣지 않습니다. 물어본 것을 못 하면 AI 는 그럴듯하게 지어내고, 그 답이 틀렸다는 것을 사용자는 알 수 없습니다.
AI 가 딴 숫자를 말하지 않게 하는 것
- 화면과 같은 리포트를 실행합니다AI 전용 조회 경로를 따로 만들지 않았습니다. 대화창의 미수채권 합계와 미수채권현황 화면의 합계가 어긋날 수 없는 이유입니다 — 답이 미심쩍으면 그 화면을 열어 대조하십시오.
- 총계는 전체 기준으로 함께 보냅니다표에 20행만 실려도 총계는 전체 건수 기준입니다. 실린 행만 더하면 총계와 다르다는 것도 같이 알려 줍니다 — AI 가 페이지분을 더해 답하는 사고를 막습니다.
- 기간을 못 거는 자료는 못 건다고 말합니다미수채권처럼 전체 누계로만 나오는 자료는 도구 설명에 그렇게 적혀 있습니다. 기간을 조용히 무시하고 답하면 AI 는 자기가 건 조건이 먹은 줄 압니다.
- 코드가 아니라 이름으로 옵니다"T0012"가 아니라 거래처 이름이 함께 들어갑니다. 화면의 규칙이 AI 가 받는 표에도 그대로 적용됩니다.
- 없는 문은 보이지도 않습니다계약하지 않은 모듈·관리자 전용 자료의 도구는 목록에서 아예 빠집니다. 열리지 않는 문을 두드리다 그럴듯한 답을 지어내는 상황 자체가 생기지 않습니다.
쓰지 않기로 한 것 — 제약이 아니라 설계입니다
입력·수정·삭제 도구를 만들지 않았습니다. 잘못 들어간 값은 되돌리기 어렵고, 무엇보다 "누가 이 전표를 만들었나"에 답할 수 없게 됩니다. 회계장부에서 그 답이 사라지는 것은 기능 하나를 잃는 것과 다릅니다. 장부는 사람이 씁니다.
미리 밝히는 두 가지
대화 내용은 AI 서비스로 갑니다
연결한 AI 제공사(Anthropic·OpenAI 등)로 질문과 답이 전송됩니다. 우리가 통제할 수 있는 범위 밖이므로, 무엇까지 물을지는 회사가 정할 몫입니다.
회사 단위 키입니다
개인 계정이 아니라 회사 단위로 열립니다 — 키를 가진 쪽이 곧 조회 범위입니다. 사람처럼 관리하고, 필요 없어지면 관리자 화면에서 즉시 폐기하십시오. 폐기하면 그 연결은 바로 닫힙니다. 대신 키마다 읽을 범위를 정할 수 있습니다 — 아래를 보십시오.
키마다 읽을 범위를 정합니다
발급할 때 그 키가 읽을 자료만 고릅니다. 재고만 여는 키, 회계만 여는 키를 따로 두면 현장 시스템에 준 키로 시산표가 열리는 일이 없습니다. 범위 밖 도구는 목록에 나타나지도 않고, 이름을 알고 불러도 데이터를 주지 않습니다. 발급 후에는 범위를 넓힐 수 없습니다 — 넓힐 수 있게 두면 "이 키는 재고만 본다"는 약속이 조용히 깨지기 때문입니다. 아무것도 고르지 않으면 전체가 열립니다(기존 키와 같은 동작).
읽을 수 있는 자료 10종
| 자료 | 도구 이름 |
|---|---|
| 현재고 | stock_current |
| 월별 매출 | sales_monthly |
| 미수채권 | receivable |
| 수주 미납 | sorder_open |
| 발주 미납 | purord_open |
| 합계잔액시산표 | trial_balance |
| 자재부족 | stock_short |
| 미수채권 연체구간 | receivable_aging |
| 재고금액 | stock_value |
| 자금일보 | cash_daily |
AI 가 읽을 수 있게 만들어 둔 것
AI 연결은 도구 목록만의 이야기가 아닙니다. 제품과 문서 전체가 기계 판독 가능한 형태로 나옵니다.
MCP 서버
표준(2025-06-18)을 지원하는 AI 도구가 붙습니다. 어댑터를 따로 만들지 않습니다. 연결 방법(개발자)
OpenAPI 3.1
외부연동 API 전체 스펙을 키 없이 공개합니다. 검토하는 개발자도, 코드를 쓰는 AI 도 계약 전에 먼저 읽습니다. openapi.json
Markdown 도움말
화면별 사용설명서를 사람용 HTML 과 기계용 Markdown 으로 함께 냅니다. 주소 끝에 .md 를 붙이면 원문이 열립니다.
도움말 전체