Skip to content

ChatGPT·Claude·Gemini에서 쇼기 도장 사용하기

평소 대화하는 AI에 쇼기 도장을 연결하면, 대국을 함께 복기하고, 어떤 국면에서 플레이어들이 주로 두는 수를 찾아보고, 실수한 수를 복습 목록으로 만들 수 있습니다. 당신이 허용한 뒤에만, 그리고 당신의 계정으로만 동작합니다.

1 할 수 있는 일

연결하면 AI는 다섯 가지 도구를 쓸 수 있습니다. 요청한 내용에 필요할 때만, 그리고 당신 자신의 계정 범위에서만 사용합니다.

  • 내 대국 목록 — 내 대국을 최신순으로. 결과나 상대로 좁히고, 더 이전 페이지로 거슬러 올라갈 수 있습니다.
  • 대국 읽기 — 한 대국 전체: 대국자, 결과, 제한 시간, 모든 수(USI 및 일본식 표기)와 KIF 기보.
  • 국면 탐색 — SFEN으로 지정한 국면에서 쇼기 도장 대국 데이터베이스의 플레이어들이 고른 수와, 각 수가 둔 횟수와 비율을 단급 구간별로. 공개 대국의 통계이며 플레이어 이름은 포함하지 않습니다.
  • 내 복습 목록 보기 — 내 복습(다음 한 수 퀴즈) 목록.
  • 복습 목록 만들기 — 국면들로 새 목록을 만들며, 각 국면에 정답 수와 코멘트를 붙입니다. 만들기만 할 뿐, 기존 목록이나 대국, 그 밖의 어떤 것도 수정하거나 삭제할 수 있는 도구는 없습니다.

2 이렇게 물어보세요

  • “지난 대국을 복기하고 어디서 형세가 기울었는지 알려 줘.”
  • “이번 달에 누구에게 졌고, 그 대국들은 어떻게 끝났어?”
  • “그 대국 30수째 이후 국면에서 더 강한 사람들은 보통 뭘 둬?”
  • “최근 세 번 진 대국에서 내가 틀린 수로 ‘나의 실수’라는 복습 목록을 만들어 줘.”

3 연결하기

어떤 방법으로 연결하든, 마지막에는 로그인한 상태의 쇼기 도장 페이지에서 허용할지 묻습니다. AI 앱에 입력할 주소는 다음과 같습니다:

https://shogidojo.online/api/mcp
ChatGPT

ChatGPT 플러그인 디렉터리에 쇼기 도장이 등록되면 거기서 찾아 '연결'을 선택하세요. 그 전까지는 개발자 모드가 있는 계정에서 추가할 수 있습니다: 설정 → 보안 및 로그인 → 개발자 모드를 켠 뒤, chatgpt.com/plugins의 + 버튼에서 위 주소를 입력합니다.

claude.ai

맞춤 커넥터로 추가합니다: 사용자 지정 → 커넥터 → 맞춤 커넥터 추가에서 위 주소를 입력하세요. 처음 도구를 사용할 때 Claude가 로그인 페이지를 엽니다.

Claude Code

터미널에서 서버를 추가한 뒤, Claude Code에서 /mcp를 실행해 로그인합니다:

claude mcp add --transport http shogidojo https://shogidojo.online/api/mcp
Gemini CLI

Gemini도 같은 원격 서버에 연결하므로 설치할 것이 없습니다. Gemini CLI에서 /mcp auth shogidojo를 실행해 로그인합니다:

gemini mcp add --transport http shogidojo https://shogidojo.online/api/mcp

4 연결 방식

  • AI 앱이 쇼기 도장 서버에 요청하면, 당신의 허가가 필요하다는 것과 어디서 허가를 구해야 하는지 안내받습니다.
  • AI 앱이 브라우저에서 쇼기 도장 페이지를 엽니다. 로그인되어 있지 않다면 연결할 계정으로 먼저 로그인합니다.
  • 페이지에는 앱 이름, 응답이 전송될 웹사이트, 그리고 읽기만 요청하는지 복습 목록 생성까지 요청하는지가 표시됩니다. '허용' 또는 '거부'를 누릅니다.
  • 허용하면 앱은 당신의 계정용 키를 받습니다. 키는 1시간 동안 유효하며, 사용하는 동안 자동으로 갱신됩니다. 비밀번호는 절대 쇼기 도장 밖으로 나가지 않습니다.

5 권한

  • 읽기 및 쓰기 — 일반적인 연결입니다. 앱은 다섯 가지 도구를 모두 사용할 수 있습니다. 쓰기는 오직 새 복습 목록을 만드는 것뿐입니다.
  • 읽기 전용 — 앱이 읽기만 요청한 경우입니다. 목록 생성은 서버가 거부합니다.
  • 어느 쪽이든 앱은 연결한 계정으로 동작하며, 그 계정의 대국과 목록, 그리고 공유 국면 통계에만 접근합니다. 수를 두거나, 프로필·비밀번호·설정을 바꾸거나, 무엇이든 삭제할 수는 없습니다.

6 AI가 보는 것, 우리가 보관하는 것

  • AI가 받는 것은 사용하는 동안 도구가 돌려준 내용뿐입니다 — 내 대국, 그 수와 기보, 내 복습 목록, 국면 통계. 이 정보는 이후 AI 제공업체가 자체 개인정보 처리방침에 따라 보관하며, AI에게 말한 다른 내용과 마찬가지입니다.
  • AI와의 대화를 저희가 받는 일은 없습니다. 저희가 보관하는 것은 연결 자체입니다: 앱 이름, 리디렉션 주소, 허용된 작업, 마지막 사용 시각, 그리고 키의 해시 — 키 자체는 절대 보관하지 않습니다.
  • AI가 만든 복습 목록은 직접 만든 것과 똑같이 계정에 저장됩니다.
  • 90일 동안 아무도 사용하지 않은 연결은 자동으로 종료됩니다.

7 연결 해제

쇼기 도장에서 계정 설정을 열고 '연결된 앱'에서 해당 앱의 연결을 해제하세요. AI 앱에 아직 무엇이 표시되든 즉시 작동이 멈춥니다. AI 앱에서 커넥터를 삭제하는 것만으로는 저희 쪽의 키가 폐기되지 않습니다.

자주 묻는 질문

AI가 내 대국이나 복습 목록을 변경하거나 삭제할 수 있나요?
아니요. 쓸 수 있는 것은 새 복습 목록뿐이며, 이는 AI에 맡기지 않고 서버에서 확인합니다. 수정과 삭제는 쇼기 도장 앱에서만 할 수 있습니다.
AI가 나 대신 대국을 둘 수 있나요?
아니요. 대국을 시작하거나 수를 둘 수 있는 도구는 없습니다.
다른 플레이어의 대국도 볼 수 있나요?
자신의 대국만 볼 수 있습니다. 국면 탐색은 공개 대국에서 각 수가 몇 번 두어졌는지 보여 주지만, 누가 두었는지는 알려 주지 않습니다.
읽기 전용으로 연결할 수 있나요?
네, 앱이 읽기만 요청하는 경우에 가능합니다. 승인하는 페이지에 무엇을 요청하는지 표시되며, 읽기 전용 연결로는 아무것도 만들 수 없습니다.
비용이 드나요?
연결은 무료입니다. 요금제의 제한은 앱에서 사용할 때와 똑같이 적용됩니다.

개발자용

https://shogidojo.online/api/mcp 에 있는 Streamable HTTP 기반 원격 MCP 서버로, PKCE (S256)를 사용하는 OAuth 2.1, https://shogidojo.online/api/oauth/register 의 동적 클라이언트 등록, RFC 9207 발급자 식별로 보호됩니다. 메타데이터: https://shogidojo.online/.well-known/oauth-protected-resource/api/mcp 및 https://shogidojo.online/.well-known/oauth-authorization-server.