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

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 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

1. Asistentes de lista
   { "name": "list_assistants", "arguments": {} }
   Devuelve una lista de todos los asistentes disponibles para el usuario autenticado.
2. 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:

Uso en la configuración de MCP

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

Flujo de autenticación

1. 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
2. El token de autenticación se guarda automáticamente y se utiliza para solicitudes posteriores.
3. Todas las herramientas relacionadas con el asistente requieren autenticación antes de su uso

Mensajes de error

Mensajes de error comunes y sus significados:

• "No ha 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
• "No se pudo preguntar al asistente": Error al enviar la pregunta al asistente