Claude Code 연결 (MCP)

Ian On은 다른 AI 도구에서도 닿을 수 있습니다. Claude Code나 MCP(AI 도구를 데이터에 연결하는 공통 표준)를 쓰는 다른 앱을 사용한다면, 그 도구가 운영 브레인을 직접 검색하고 질문하게 할 수 있습니다 — 파일을 수동으로 내보낼 필요 없이요. 연결된 도구는 내 계정이 볼 수 있는 것만큼만 닿을 수 있고, 그 이상은 안 됩니다.

관리자일 필요는 없습니다. 로그인한 사용자라면 누구나 자기 키를 만들 수 있습니다.

외부 도구가 할 수 있는 일

연결되면 그 도구는 네 가지 능력을 얻습니다. 모두 내 계정에 허용된 범위로 제한됩니다.

• 회사 지식 검색 (ian_search).
• 출처가 붙은 근거 있는 답변 질문 (ian_ask). 업무로 처리할 요청이면 답 대신 ian_work_create로 업무를 만들라고 알려 줍니다.
• 결정 조회 (ian_decision_query) — 업무 하나를 정해, 그 업무의 결정 원장에서 누가 무엇을 왜 언제 결정했는지.
• 목표로 업무 시작 (ian_work_create) — 내 개인 업무를 만들고 계획을 세우기 시작하며, 그 업무 링크를 돌려줍니다.

결정 조회에는 조회할 업무의 id(UUID)를 workspaceId로 꼭 지정해야 합니다. id는 업무 화면 주소 /work/<id>의 <id> 부분입니다. 역할과 관계없이 한 번에 업무 하나만 조회하며, 팀 업무는 지금 그 팀 소속일 때만, 개인 업무는 만든 사람만 조회할 수 있습니다.

ian_work_create 요청에는 요청 _meta의 ian-on/logical-action-id 값을 선택으로 보낼 수 있습니다. 값은 영문·숫자와 . _ : -로 된 1~200자이며, 형식에 맞지 않으면 오류로 돌아옵니다. 같은 요청을 다시 시도할 때 같은 값을 보내면 같은 업무가 돌아오고, 값을 보내지 않으면 호출할 때마다 새 업무가 만들어집니다.

설정하기

1. 설정 → MCP API 키를 엽니다.
2. 원하면 키 이름(예: Claude Code)을 입력하고 생성을 누릅니다.
3. 키는 한 번만 보입니다 — 지금 복사로 복사해 안전하게 보관하세요. 다시 볼 수 없습니다.
4. 페이지에 바로 붙여 넣을 설정도 함께 보입니다. 도구의 .mcp.json에 넣으세요.

{
  "mcpServers": {
    "ian-on": {
      "type": "http",
      "url": "https://<your-ian-on>/api/mcp",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

클라이언트를 다시 시작하고 네 가지 도구가 표시되는지 확인합니다. 도구만 제공하므로 리소스·프롬프트 목록은 비어 있어도 정상입니다. 도구별 입력과 오류 해결 방법은 앱의 설정 → MCP API 키 → 연결 안내에서 확인합니다.

접근을 취소하려면 같은 항목에서 키 옆 폐기를 누르고, 확인 창에서 한 번 더 확인하세요. 폐기는 되돌릴 수 없으며, 그 키를 쓰던 외부 도구는 바로 접근을 잃습니다.