Folderr MCP Server

Servidor MCP Folderr

Um servidor Model Context Protocol (MCP) que fornece ferramentas para interagir com a API do Folderr, especificamente para gerenciar e se comunicar com os Assistentes do Folderr.

Instalação

Adicione às suas configurações do MCP

{
  "mcpServers": {
    "folderr": {
      "command": "npx",
      "args": ["-y", "@folderr/folderr-mcp-server"]
    }
  }
}

Recursos

O servidor fornece as seguintes ferramentas:

Autenticação

Dois métodos de autenticação são suportados:

1. Login com Email/Senha

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

2. Autenticação por Token de API

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

   Os tokens de API podem ser gerados na seção de desenvolvedores do Folderr. Este método é recomendado para processos automatizados ou de longa duração.

Gerenciamento de Assistentes

1. Listar Assistentes

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

   Retorna uma lista de todos os assistentes disponíveis para o usuário autenticado.

2. Perguntar ao Assistente

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

   Envie uma pergunta a um assistente específico e receba a resposta dele.

Configuração

O servidor armazena sua configuração em um arquivo config.json, que inclui:

• URL base para a API do Folderr
• Token de autenticação (de login ou chave de API)

Tratamento de Erros

O servidor fornece mensagens de erro detalhadas para cenários comuns:

• Falhas de autenticação
• Requisições inválidas
• Erros de API
• Problemas de rede

Desenvolvimento

Para compilar o servidor:

npm install
npm run build

Uso nas Configurações do MCP

Adicione o seguinte à sua configuração de MCP:

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

Fluxo de Autenticação

1. Ou:
   • Use a ferramenta login com email e senha
   • Use a ferramenta set_api_token com um token de API da seção de desenvolvedores do Folderr
2. O token de autenticação é salvo automaticamente e usado para requisições subsequentes
3. Todas as ferramentas relacionadas a assistentes exigem autenticação antes do uso

Mensagens de Erro

Mensagens de erro comuns e seus significados:

• "Não autenticado": Nenhum token de autenticação está definido
• "Falha no login": Credenciais inválidas
• "Falha ao listar assistentes": Erro ao recuperar a lista de assistentes
• "Falha ao perguntar ao assistente": Erro ao enviar pergunta ao assistente