폴더 MCP 서버

Folderr의 API와 상호 작용할 수 있는 도구를 제공하는 MCP(Model Context Protocol) 서버로, 특히 Folderr Assistant를 관리하고 통신하기 위한 것입니다.

설치

MCP 설정에 추가

지엑스피1

Related MCP server: Filesystem MCP Server

특징

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

입증

두 가지 인증 방법이 지원됩니다.

1. 이메일/비밀번호로 로그인

   {
     "name": "login",
     "arguments": {
       "email": "user@example.com",
       "password": "your-password"
     }
   }

2. API 토큰 인증

   {
     "name": "set_api_token",
     "arguments": {
       "token": "your-api-token"
     }
   }

   API 토큰은 Folderr 개발자 섹션에서 생성할 수 있습니다. 이 방법은 자동화되거나 장기 실행 프로세스에 권장됩니다.

보조 관리

1. 목록 도우미

   {
     "name": "list_assistants",
     "arguments": {}
   }

   인증된 사용자에 대해 사용 가능한 모든 보조자 목록을 반환합니다.

2. 어시스턴트에게 문의하기

   {
     "name": "ask_assistant",
     "arguments": {
       "assistant_id": "assistant-id",
       "question": "Your question here"
     }
   }

   특정 보조원에게 질문을 보내 답변을 받으세요.

구성

서버는 다음을 포함하는 config.json 파일에 구성을 저장합니다.

• Folderr API의 기본 URL

• 인증 토큰(로그인 또는 API 키)

오류 처리

서버는 일반적인 시나리오에 대한 자세한 오류 메시지를 제공합니다.

• 인증 실패

• 잘못된 요청

• API 오류

• 네트워크 문제

개발

서버를 빌드하려면:

npm install
npm run build

MCP 설정에서의 사용

MCP 설정 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "folderr": {
      "command": "node",
      "args": ["/path/to/folderr-server/build/index.js"]
    }
  }
}

인증 흐름

1. 어느 하나:

   • 이메일과 비밀번호를 사용하여 login 도구를 사용하세요

   • Folderr 개발자 섹션의 API 토큰과 함께 set_api_token 도구를 사용하세요.

2. 인증 토큰은 자동으로 저장되어 후속 요청에 사용됩니다.

3. 모든 보조 관련 도구는 사용 전 인증이 필요합니다.

오류 메시지

일반적인 오류 메시지와 의미:

• "로그인 안 됨": 인증 토큰이 설정되지 않았습니다.

• "로그인 실패": 잘못된 자격 증명입니다.

• "보조원 목록을 나열하는 데 실패했습니다": 보조원 목록을 검색하는 중 오류가 발생했습니다.

• "어시스턴트에게 질문하는 데 실패했습니다": 어시스턴트에게 질문을 보내는 중 오류가 발생했습니다.