Cairni 위키를 모든 AI 클라이언트에서
Cairni는 MCP 서버를 제공합니다. Claude·Cursor·Codex 같은 클라이언트가 당신의 위키(본인 것 + 공유받은 것)를 검색·읽기·질문하고, 직접 편찬까지 합니다. OAuth로 한 번만 연결하면 토큰 복붙도 필요 없습니다.
- 엔드포인트
- https://mcp.cairni.com/
- 전송
- Streamable HTTP
- 인증
- OAuth 2.1 · 동적 클라이언트 등록 · 또는 PAT
OAuth로 연결 (추천)
가장 빠른 방법 — 브라우저에 동의 화면이 뜨고 '허용'만 누르면 됩니다.
서버 추가
claude mcp add --transport http cairni https://mcp.cairni.com/브라우저에서 승인
완료
Claude Desktop·claude.ai(Team / Enterprise): 설정 → 커넥터에서 같은 URL로 Cairni를 추가하면 동일한 '허용' 화면이 나옵니다.
토큰으로 연결
스크립트·CI·OAuth 미지원 클라이언트용 — 개인 액세스 토큰(PAT)을 사용하세요.
토큰 발급
헤더로 추가
claude mcp add --transport http cairni https://mcp.cairni.com/ \
--header "Authorization: Bearer cairni_pat_…"{
"mcpServers": {
"cairni": {
"type": "http",
"url": "https://mcp.cairni.com/",
"headers": { "Authorization": "Bearer cairni_pat_…" }
}
}
}다른 클라이언트
Cairni는 표준 remote-MCP 프로토콜을 따릅니다 — MCP를 지원하는 어떤 클라이언트든 같은 엔드포인트로 붙습니다. 로컬(stdio) 서버만 지원하는 클라이언트는 mcp-remote 브리지가 OAuth 흐름까지 대신 처리합니다.
{
"mcpServers": {
"cairni": { "url": "https://mcp.cairni.com/" }
}
}또는 설정 → MCP → 새 서버 추가. 첫 사용 시 OAuth로 승인합니다.
codex mcp add cairni --url https://mcp.cairni.com/rmcp 최초 설정: ~/.codex/config.toml의 [features]에 experimental_use_rmcp_client = true 추가 후 codex mcp login cairni 실행.
npx -y mcp-remote https://mcp.cairni.com/로컬(stdio) 서버만 지원하는 클라이언트는 이 명령을 서버 커맨드로 등록하세요(command: npx, args: -y mcp-remote <url>). 브리지가 브라우저에 OAuth 동의를 띄우고 도구를 중계합니다.
도구
모든 도구는 당신 권한으로 동작합니다 — 본인 것과 공유받은 위키만 보입니다.
| 도구 | 기능 | 스코프 | 비용 |
|---|---|---|---|
| list_wikis | 접근 가능한 위키 목록 | wiki:read | 무료 |
| read_page | 페이지 마크다운 읽기 | wiki:read | 무료 |
| search | 위키 전체 검색 | wiki:read | 무료 |
| ask | 출처 인용 그라운디드 Q&A | wiki:ask | 크레딧 |
| put_page | 페이지 직접 작성(raw) | wiki:write | 무료 |
| create_wiki | 새 위키 생성 | wiki:write | 무료 |
| ingest | 원자료를 넘겨 Cairni가 편찬 | wiki:write | 크레딧 |
put_page는 클라이언트가 작성한 마크다운을 그대로 저장 — Cairni AI를 안 거쳐 무료입니다. ask·ingest는 Cairni LLM을 써서 그 위키 워크스페이스의 크레딧을 사용합니다.
스코프·보안
- wiki:read위키·페이지 읽기·검색.
- wiki:ask그라운디드 질문(크레딧 사용).
- wiki:write위키 생성·페이지 편집.
연결할 준비됐나요?
토큰을 발급하거나 Cairni를 열어 시작하세요.