# API·MCP로 워크스페이스·브레인 읽고 쓰기

> Source: https://wisdombase.ai/@help/features/api · Last updated: 2026-11-05

AI 도구나 스크립트가 **워크스페이스와 브레인을 골라서, 페이지를 읽고 만들고 고치고 지우게** 할 수 있어요. 열쇠는 **계정 API 토큰** 하나예요. 같은 토큰을 MCP(Claude·ChatGPT·Cursor)와 REST API 양쪽에 써요.

## 1. 토큰 만들기

**계정 → API 토큰**에서 이름을 적고 만들어요.

- **읽기·쓰기** — 찾기·읽기에 더해 만들기·고치기·지우기까지 돼요.
- **읽기 전용** — 찾기·읽기만 돼요. 쓰기 도구는 목록에 보이지도 않아요.
- 만료일을 정할 수 있고, 목록에서 언제든 **폐기**하면 그 순간부터 쓸 수 없어요.

토큰은 만들 때 **한 번만** 보여요. 복사해서 안전한 곳에 두세요.


토큰은 비밀번호와 같아요. 공개 채팅이나 문서에 붙여 넣지 마세요. 새어 나갔다면 바로 폐기하고 새로 만드세요.


## 2. 연결하기

- **Claude Code** — `claude mcp add --transport http wisdombase https://wisdombase.ai/mcp --header "Authorization: Bearer 토큰"`
- **ChatGPT·Claude 웹 같은 커넥터** — 주소 한 칸이라 `https://wisdombase.ai/mcp?k=토큰` 을 넣어요.
- **한 브레인에만 묶고 싶다면** — `https://wisdombase.ai/@브레인주소/mcp?k=토큰` 처럼 브레인 주소 뒤에 같은 토큰을 써요.

연결한 AI에게 이렇게 말하면 돼요. 「내 워크스페이스 보여 줘」 → 「삼성 시범단 워크스페이스의 브레인 목록」 → 「삼성 FAQ에 ‘환불 안내’ 페이지 만들어 줘」.

## 3. 어떤 도구가 있나요

| 하는 일 | 도구 |
| --- | --- |
| 길 찾기 | `list_workspaces`(조직 › 워크스페이스), `list_brains`, `get_brain` |
| 읽기 | `search_docs`, `list_pages`, `read_outline`, `read_page` |
| 페이지 쓰기 | `create_page`, `update_page`(교체·덧붙이기), `edit_page`(일부만 바꾸기), `move_page`, `delete_page` |
| 구조 | `create_group`·`update_group`·`delete_group`, `create_section`·`update_section`·`delete_section` |
| 만들기 | `create_workspace`, `create_brain`, `update_brain` |

고치기 전에 `read_page`로 **rev**를 읽어 `base_rev`로 넘기면, 그사이 다른 사람이 고쳤을 때 충돌로 알려 줘서 덮어쓰지 않아요. 지우기는 `confirm: true`를 줘야 해요.

## 권한은 어떻게 되나요

- 토큰은 **그 사람의 권한만큼만** 일해요. 내가 못 보는 브레인은 토큰으로도 보이지 않고, **게스트는 초대된 워크스페이스의 브레인만** 열려요.
- 조직에서 내보내거나 워크스페이스에서 빠지면 그 브레인에는 토큰이 즉시 닿지 않아요.
- **「검토 후 반영」 모드** 브레인은 편집자 토큰으로 직접 고칠 수 없어요(승인자·소유자 토큰은 가능).
- 조직 소유자가 **보안·AI 정책**에서 「AI 접근」「MCP」「AI 쓰기」를 끄면 그 조직 브레인에는 토큰이 닿지 않거나 쓰기가 거절돼요.
- 본문에 API 키·토큰 같은 **비밀 값**이 보이면 저장하지 않고 알려 줘요.
- 조직의 **감사 로그**가 켜져 있으면 API·MCP로 한 쓰기와 삭제가 함께 남아요.

## 4. REST API

기준 주소는 `https://wisdombase.ai/api/v1` 이에요. 헤더 `Authorization: Bearer 토큰` 으로 불러요.

```
curl -H "Authorization: Bearer $WB" https://wisdombase.ai/api/v1/workspaces
curl -H "Authorization: Bearer $WB" "https://wisdombase.ai/api/v1/brains?workspace=삼성%20시범단"
curl -X POST -H "Authorization: Bearer $WB" -H "Content-Type: application/json" \
  -d '{"title":"설치 가이드","md":"# 설치"}' https://wisdombase.ai/api/v1/brains/kb-3/pages
```

API 필드 이름은 예전 그대로 `team`·`teams`예요(= 조직). 모든 경로와 매개변수, 오류 코드는 **[API·MCP 문서](https://wisdombase.ai/@help/docs/api)** 와 **OpenAPI 명세**(`/api/v1/openapi.json`)에 있어요.

## 예전 「브레인별 읽기 키」는요

브레인의 **AI 연결** 탭에 있는 `dk_…` 키가 든 MCP 주소는 그대로 **읽기·검색용**이에요(비공개 브레인에 한해 에이전트 기록 도구도 있어요). 워크스페이스를 고르고 쓰기까지 하려면 위의 계정 API 토큰을 쓰세요.