remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrated with npm for installation, allowing the Folderr MCP server to be easily added via npx.
Supports TypeScript for defining tool arguments, providing type safety when interacting with Folderr's API.

폴더 MCP 서버

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

설치

MCP 설정에 추가

지엑스피1

특징

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

입증

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

이메일/비밀번호로 로그인
{ "name": "login", "arguments": { "email": "user@example.com", "password": "your-password" } }
API 토큰 인증
{ "name": "set_api_token", "arguments": { "token": "your-api-token" } }
API 토큰은 Folderr 개발자 섹션에서 생성할 수 있습니다. 이 방법은 자동화되거나 장기 실행 프로세스에 권장됩니다.

보조 관리

목록 도우미
{ "name": "list_assistants", "arguments": {} }
인증된 사용자에 대해 사용 가능한 모든 보조자 목록을 반환합니다.
어시스턴트에게 문의하기
{ "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"]
    }
  }
}

인증 흐름

어느 하나:
- 이메일과 비밀번호를 사용하여 login 도구를 사용하세요
- Folderr 개발자 섹션의 API 토큰과 함께 set_api_token 도구를 사용하세요.
인증 토큰은 자동으로 저장되어 후속 요청에 사용됩니다.
모든 보조 관련 도구는 사용 전 인증이 필요합니다.

오류 메시지

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

"로그인 안 됨": 인증 토큰이 설정되지 않았습니다.
"로그인 실패": 잘못된 자격 증명입니다.
"보조원 목록을 나열하는 데 실패했습니다": 보조원 목록을 검색하는 중 오류가 발생했습니다.
"어시스턴트에게 질문하는 데 실패했습니다": 어시스턴트에게 질문을 보내는 중 오류가 발생했습니다.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools