Lichess MCP: Claude를 Lichess에 연결하기
Lichess MCP는 Claude 같은 AI 어시스턴트가 Lichess API를 호출할 수 있게 해 주는 서버예요. 가장 잘 알려진 karayaman/lichess-mcp는 오픈소스이고 약 190개의 도구를 제공해요. 내 계정, 대국 내보내기, 퍼즐, 오프닝 탐색기, Lichess 클라우드 평가, 그리고 켜기만 하면 대국 두기까지요. Lichess 토큰을 가지고 내 컴퓨터에서 실행해요.
MCP, 즉 Model Context Protocol은 어시스턴트가 외부 도구를 호출할 때 쓰는 개방형 표준이에요. "서버"는 그런 도구를 제공하는 프로그램이고요.
Lichess MCP 서버 한눈에 보기
2026년 10월 25일에 각 프로젝트의 README에서 확인한 내용이에요. 스타 수와 날짜는 바뀌어요.
| 프로젝트 | Claude에게 주는 것 | 실행 방법 | 필요한 것 |
|---|---|---|---|
| karayaman/lichess-mcp | 도구 묶음(toolset)으로 나뉜 약 190개 도구, 기본으로 켜진 것은 약 70개(계정, 사용자, 대국, 퍼즐, 오프닝 탐색기, 엔드게임 테이블베이스, 분석). 대국 두기와 토너먼트는 직접 켜야 해요 | 로컬에서 npm(또는 Smithery)으로 설치하고 Claude Desktop 설정에 추가 | Lichess API 토큰, MIT 라이선스 |
| 작은 커뮤니티 저장소 | 같은 API를 감싼 여러 래퍼, karayaman 서버의 Python 포팅 포함 | 로컬 | 대부분 문서 없음, 아직 스타 없음 |
| Chess Coach (저희 제품) | 끝난 Lichess와 Chess.com 대국, Stockfish 리뷰, 인터랙티브 체스판 | 원격: URL을 붙여 넣고 로그인 | Lichess 토큰이나 비밀번호 불필요 |
여기서 자리를 잡은 프로젝트는 karayaman/lichess-mcp예요. 스타가 20개 안팎이고 2026년 10월에도 커밋이 있었어요. README는 보안에 신경을 많이 써요. 일부 도구는 내 계정에서 실제로 동작하고, 모델이 다른 Lichess 사용자가 쓴 글을 읽기 때문에, 토큰은 시스템의 비밀 저장소에 두고 필요한 권한만 체크하라고 권해요.
Claude Desktop용 인터랙티브 도구도 있어서 채팅 안에 실제 체스판을 보여 줘요. 퍼즐 풀이, 대국 뷰어, 오프닝 트리예요. Chess Coach의 체스판과 같은 확장 기능인 MCP Apps를 써요.
MCP를 통한 Lichess AI 분석: API가 실제로 돌려주는 것
많은 사람이 내 대국의 "Lichess AI 분석"을 기대하며 Lichess MCP를 설치해요. API의 분석 기능 두 가지는 모두 조건이 붙어 있어서 먼저 알아 두는 게 좋아요.
클라우드 평가. Lichess 문서는 이 기능을 포지션의 저장된 평가를 "가능한 경우" 돌려주는 것이라고 설명해요. 데이터베이스에는 약 3억 2천만 개의 포지션이 있고, 오프닝 포지션이 들어 있을 가능성이 가장 높아요. 특이한 수 몇 개를 지난 내 대국의 중반 포지션은 없는 경우가 많아요.
평가를 포함한 대국 내보내기. 대국을 내보낼 때 Lichess는 엔진 평가와 정확도 수치를 "가능한 경우" 포함할 수 있어요. 즉 그 대국을 이미 Lichess에서 분석했을 때예요. 분석을 요청한 적이 없다면 내보낸 파일에는 수만 들어 있어요.
그러니 Lichess MCP는 Claude에게 훌륭한 데이터를 주지만, 필요할 때 엔진을 돌려 주지는 않아요. 빈 곳은 Claude가 자기 판단으로 채워요. 언어 모델은 체스 엔진이 아니라서 포지션을 잘못 읽을 수 있어요. 이 부분은 클로드 체스 분석, 가능할까?에서 설명해요. 어떤 포지션이든 확인하고 싶다면 별도의 Stockfish MCP 서버를 추가하거나, 사이트에 있는 Lichess의 무료 분석 보드를 쓰면 돼요.
Lichess MCP 서버 vs 리뷰 커넥터
둘은 서로 다른 문제를 풀어요.
- 완전한 Lichess MCP 서버는 채팅에서 Lichess 일을 처리할 때 써요. 프로필 확인, 퍼즐 둘러보기, 도전이나 팀 관리 같은 일이요. 무료이고 유연하지만, 실행과 보안은 직접 챙겨야 해요.
- 리뷰 커넥터는 한 가지 일, 즉 끝난 대국을 이해하는 데 써요. 엔진, 체스판, 설명이 필요하고, 내 계정에 쓰기 권한은 필요 없어야 해요.
Chess Coach가 Lichess 대국을 다루는 방법
Chess Coach는 Claude와 ChatGPT용 원격 MCP 서버예요. Claude에서
https://chess-coach-246271308938.europe-west1.run.app/mcp를 사용자 지정 커넥터로 추가하고
(설정 방법), 이메일이나 Google로 로그인한 다음 Lichess 사용자 이름을 알려 주세요.
list_games는 끝난 Lichess 대국을 보여 주고, 월, 상대, 결과, 색, 시간 제한, 오프닝으로 검색할 수 있어요.review_game은 저장된 평가가 아니라 저희 서버에서 모든 수에 Stockfish를 돌려서, 특이한 포지션에서도 작동해요.- 인터랙티브 체스판은 핵심 순간 ①②③, 평가 그래프, 화살표(여러분의 수는 빨간색, 더 나은 수는 초록색)를 보여 줘요. 실수 연습(Practice mistakes) 모드로 잘못 둔 포지션을 다시 풀어 볼 수 있어요.
자격 증명 없이 공개 대국을 읽고, 진행 중인 대국은 절대 돕지 않아요. 무료 플랜에는 하루 1회 심층 리뷰와 30회 포지션 확인이 포함되고, Plus는 월 $3.99, Pro는 월 $7.99예요. Chess Coach는 Claude 디렉터리와 OpenAI 플러그인 디렉터리에서 사용할 수 있어요. 소개 페이지를 열고 설치한 다음 Chess Coach 계정으로 로그인하세요. 리뷰에 무엇이 담기는지는 AI 체스 분석에서 볼 수 있어요. Chess.com에서도 둔다면 Chess.com MCP 서버를, Lichess의 무료 리뷰와 Chess.com 리뷰의 비교는 비교 페이지를 참고하세요.
Chess Coach는 Lichess와 제휴 관계가 아니에요.
자주 묻는 질문
공식 Lichess MCP 서버가 있나요?
2026년 10월 기준으로 찾지 못했어요. 가장 잘 알려진 karayaman/lichess-mcp는 공개 Lichess API를 감싼 MIT 라이선스의 오픈소스 커뮤니티 프로젝트예요.
Lichess 토큰이 필요한가요?
karayaman/lichess-mcp는 필요해요. Lichess에서 개인 API 토큰을 만들고, 필요한 권한(scope)만 체크하는 게 좋아요. 끝난 공개 대국을 읽는 데는 Lichess 비밀번호가 필요 없고, Chess Coach는 Lichess 토큰도 비밀번호도 묻지 않아요.
Lichess 클라우드 평가는 어떤 포지션이든 분석하나요?
아니요. 포지션이 Lichess의 약 3억 2천만 개 포지션 데이터베이스에 이미 있을 때만 저장된 평가를 돌려줘요. 오프닝 포지션은 있는 경우가 많지만, 내 대국의 특이한 미들게임 포지션은 없는 경우가 많아요.
Claude에서 Lichess 대국의 AI 분석을 받을 수 있나요?
네. Chess Coach를 연결하고 Claude에게 Lichess 사용자 이름이나 대국 링크를 알려 주세요. 저희 서버에서 Stockfish가 끝난 대국을 리뷰하고, Claude가 인터랙티브 체스판 위에서 핵심 순간을 설명해요.