Folderr MCP Server

Folderr MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para interactuar con la API de Folderr, específicamente para gestionar y comunicarse con los asistentes de Folderr.

Instalación

Añade a tu configuración de MCP

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

Características

El servidor proporciona las siguientes herramientas:

Autenticación

Se admiten dos métodos de autenticación:

1. Iniciar sesión con correo electrónico/contraseña

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

2. Autenticación con token de API

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

   Los tokens de API se pueden generar desde la sección de desarrolladores de Folderr. Este método se recomienda para procesos automatizados o de larga duración.

Gestión de asistentes

1. Listar asistentes

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

   Devuelve una lista de todos los asistentes disponibles para el usuario autenticado.

2. Preguntar al asistente

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

   Envía una pregunta a un asistente específico y recibe su respuesta.

Configuración

El servidor almacena su configuración en un archivo config.json, que incluye:

• URL base para la API de Folderr
• Token de autenticación (del inicio de sesión o de la clave de API)

Manejo de errores

El servidor proporciona mensajes de error detallados para escenarios comunes:

• Fallos de autenticación
• Solicitudes no válidas
• Errores de API
• Problemas de red

Desarrollo

Para compilar el servidor:

npm install
npm run build

Uso en la configuración de MCP

Añade lo siguiente a tu configuración de MCP:

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

Flujo de autenticación

1. O bien:
   • Usa la herramienta login con correo electrónico y contraseña
   • Usa la herramienta set_api_token con un token de API de la sección de desarrolladores de Folderr
2. El token de autenticación se guarda automáticamente y se utiliza para solicitudes posteriores
3. Todas las herramientas relacionadas con asistentes requieren autenticación antes de su uso

Mensajes de error

Mensajes de error comunes y sus significados:

• "No has iniciado sesión": No hay ningún token de autenticación configurado
• "Error de inicio de sesión": Credenciales no válidas
• "Error al listar asistentes": Error al recuperar la lista de asistentes
• "Error al preguntar al asistente": Error al enviar la pregunta al asistente