Servidor MCP de Folderr

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API de Folderr, específicamente para administrar y comunicarse con los Asistentes de Folderr.

Instalación

Agregar a su configuración de MCP

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

Related MCP server: MCP Server

Características

El servidor proporciona las siguientes herramientas:

Autenticación

Se admiten dos métodos de autenticación:

Iniciar sesión con correo electrónico/contraseña
{ "name": "login", "arguments": { "email": "user@example.com", "password": "your-password" } }
Autenticación de token API
{ "name": "set_api_token", "arguments": { "token": "your-api-token" } }
Los tokens de API se pueden generar desde la sección para desarrolladores de Folderr. Este método se recomienda para procesos automatizados o de larga duración.

Asistente de Gestión

Asistentes de lista
{ "name": "list_assistants", "arguments": {} }
Devuelve una lista de todos los asistentes disponibles para el usuario autenticado.
Pregúntele al asistente
{ "name": "ask_assistant", "arguments": { "assistant_id": "assistant-id", "question": "Your question here" } }
Envíe una pregunta a un asistente específico y reciba 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 API)

Manejo de errores

El servidor proporciona mensajes de error detallados para escenarios comunes:

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

Desarrollo

Para construir el servidor:

npm install npm run build

Uso en la configuración de MCP

Agregue lo siguiente a la configuración de su MCP:

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

Flujo de autenticación

Cualquiera:
- Utilice la herramienta login con correo electrónico y contraseña
- Utilice la herramienta set_api_token con un token de API de la sección de desarrolladores de Folderr
El token de autenticación se guarda automáticamente y se utiliza para solicitudes posteriores.
Todas las herramientas relacionadas con el asistente requieren autenticación antes de su uso