esa MCP Server

esa MCP 서버

이것을 일본어 로 읽어보세요

개요

이 서버는 Claude AI가 esa API 와 상호 작용할 수 있도록 MCP(Model Context Protocol)를 사용하는 인터페이스입니다.

이 MCP 서버를 사용하여 Claude AI는 ESA 문서 검색, 생성, 업데이트 등의 작업을 수행할 수 있습니다.

저장소 정보

이 저장소는 ESA MCP 서버의 독립형 구현을 제공합니다. Claude AI와 ESA를 통합하여 문서 관리를 간소화합니다.

설정

필수 조건

• Node.js 18 이상
• esa API 액세스 토큰
• esa 팀 이름

설치

지엑스피1

환경 변수 설정

MCP 구성 예

이 MCP 서버를 사용하는 경우 mcp_config.json 파일에 다음 구성을 추가하세요.

서버 시작

사용 가능한 도구

이 MCP 서버는 다음과 같은 도구를 제공합니다.

관련 게시물

1. esa_list_posts
   • 팀의 게시물 목록을 가져옵니다
   • 입력:
     • q (문자열, 선택 사항): 검색 쿼리
     • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'comments,stargazers')
     • sort (문자열, 선택 사항): 정렬 방법(업데이트됨, 생성됨, 숫자, 별점, 시청, 댓글, 가장 잘 맞는 항목)
     • order (문자열, 선택 사항): 정렬 순서(desc, asc)
     • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)
     • page (번호, 선택 사항): 검색할 페이지 번호
2. esa_get_post
   • 특정 게시물에 대한 자세한 정보를 얻으세요
   • 입력:
     • post_number (숫자, 필수): 검색할 게시물 번호
     • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'comments,stargazers')
3. esa_create_post
   • 새로운 게시물을 만드세요
   • 입력:
     • name (문자열, 필수): 게시물 제목
     • body_md (문자열, 선택 사항): 게시물 본문(마크다운 형식)
     • tags (문자열 배열, 선택 사항): 게시물에 대한 태그 목록
     • category (문자열, 선택 사항): 게시물 카테고리
     • wip (부울, 선택 사항, 기본값: true): WIP(진행 중인 작업)로 표시할지 여부
     • message (문자열, 선택 사항): 메시지 변경
     • user (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)
     • template_post_id (숫자, 선택 사항): 템플릿으로 사용할 게시물의 ID
4. esa_update_post
   • 기존 게시물 업데이트
   • 입력:
     • post_number (숫자, 필수): 업데이트할 게시물 번호
     • name (문자열, 선택 사항): 게시물의 새 제목
     • body_md (문자열, 선택 사항): 게시물의 새 본문(마크다운 형식)
     • tags (문자열 배열, 선택 사항): 게시물에 대한 새 태그 목록
     • category (문자열, 선택 사항): 게시물의 새 카테고리
     • wip (부울, 선택 사항): WIP(진행 중인 작업)로 표시할지 여부
     • message (문자열, 선택 사항): 메시지 변경
     • created_by (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)
     • original_revision (문자열, 선택 사항): 업데이트의 기반이 되는 개정판

댓글 관련

1. esa_list_comments
   • 게시물에 대한 댓글 목록 가져오기
   • 입력:
     • post_number (숫자, 필수): 댓글을 받을 게시물 번호
     • page (번호, 선택 사항): 검색할 페이지 번호
     • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)
2. esa_get_comment
   • 구체적인 의견을 받다
   • 입력:
     • comment_id (숫자, 필수): 검색할 댓글의 ID
     • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'stargazers')
3. esa_create_comment
   • 기사에 댓글을 달아주세요
   • 입력:
     • post_number (숫자, 필수): 댓글을 달 게시물 번호
     • body_md (문자열, 필수): 주석 본문(마크다운 형식)
     • user (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)

회원 관련

1. esa_get_members
   • 팀원 목록을 받으세요
   • 입력:
     • page (번호, 선택 사항): 검색할 페이지 번호
     • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)
2. esa_get_member
   • 특정 팀원에 대한 정보를 얻으세요
   • 입력:
     • screen_name_or_email (문자열, 필수): 검색할 멤버의 화면 이름 또는 이메일

사용 예

다음은 Claude가 MCP 서버를 사용하여 ESA 게시물을 만드는 예입니다.

문제 해결

액세스 토큰 문제

이 오류가 표시되면 ESA 액세스 토큰이 유효하지 않거나 만료되었을 수 있습니다. ESA 설정 화면에서 새 액세스 토큰을 생성하고 환경 변수를 업데이트하세요.

권한 문제

이 오류가 표시되면 현재 액세스 토큰에 필요한 권한이 없는 것입니다. ESA 설정 화면에서 액세스 토큰의 권한을 확인하고 필요한 경우 새 토큰을 발급하세요.

특허

MIT 라이선스에 따라 제공됩니다.