.md

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

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 문서 와 OpenAPI 명세(/api/v1/openapi.json)에 있어요.

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

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

Last updated