# ERP AI 연동(MCP) — AI 가 우리 회사 장부를 읽습니다

> 원문: https://boltena.com/ai · 볼테나(BOLTENA)
>
> Claude·ChatGPT 같은 AI 비서를 볼테나 ERP 에 MCP 표준으로 연결해 현재고 · 월별 매출 · 미수채권 · 수주 미납 · 발주 미납 · 합계잔액시산표 · 자재부족 · 미수채권 연체구간 · 재고금액 · 자금일보 를 조회합니다. 조회 전용이라 입력·수정·삭제 도구는 제공하지 않습니다. 엔드포인트 POST https://app.boltena.com/api/ext/mcp, 프로토콜 2025-06-18, 인증은 x-api-key 헤더 하나입니다.

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) 모듈 계약이 필요합니다. 무료 플랜에는 포함되지 않습니다 — **계약이 끝나면 AI 조회는 닫힙니다.** 다만 같은 자료를 제품 화면에서 계속 보시고 엑셀로 내보낼 수 있습니다(잠기는 것은 자료가 아니라 AI 가 읽는 통로입니다) |
| 스펙 | [openapi.json](https://boltena.com/openapi.json) — 키 없이 내려받습니다 |
| 키별 범위 | 발급할 때 그 키가 읽을 자료만 지정합니다(미지정이면 전체) — 범위 밖은 목록에도 없고 호출해도 거부됩니다 |
| 감사 | 어느 키가 언제 무엇을 읽었는지 기록에 남습니다(제품의 사용현황 화면) |
| 서버 메타데이터 | [mcp-server.json](https://boltena.com/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 도구가 붙습니다. 어댑터를 따로 만들지 않습니다. [연결 방법(개발자)](https://boltena.com/developers#mcp)

### OpenAPI 3.1

외부연동 API 전체 스펙을 **키 없이** 공개합니다. 검토하는 개발자도, 코드를 쓰는 AI 도 계약 전에 먼저 읽습니다. [openapi.json](https://boltena.com/openapi.json)

### Markdown 도움말

화면별 사용설명서를 사람용 HTML 과 기계용 Markdown 으로 함께 냅니다. 주소 끝에 `.md` 를 붙이면 원문이 열립니다. [도움말 전체](https://boltena.com/docs/)

### llms.txt

AI 에이전트가 사이트 구조를 한 번에 읽는 목차를 제공합니다. [llms.txt](https://boltena.com/llms.txt) · [도움말 목차](https://boltena.com/docs/llms.txt)

[30일 무료로 연결해 보기](https://app.boltena.com/signup?src=ai_page)[연결 방법(개발자 문서)](https://boltena.com/developers#mcp)[연동 상담](https://boltena.com/contact)