esa MCP 서버

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

개요

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

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

Related MCP server: ESA MCP Server

저장소 정보

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

설정

필수 조건

• Node.js 18 이상

• esa API 액세스 토큰

• esa 팀 이름

설치

지엑스피1

환경 변수 설정

# Set environment variables
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

MCP 구성 예

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

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

서버 시작

# Start the server
npm start

사용 가능한 도구

이 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 게시물을 만드는 예입니다.

[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".

[MCP Server] Using the esa_create_post tool to create a new post.

[Result]
{
  "number": 123,
  "name": "Project X Progress Report",
  "body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
https://your-team.esa.io/posts/123

문제 해결

액세스 토큰 문제

Error: Request failed with status code 401

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

권한 문제

Error: Request failed with status code 403

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

특허

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