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

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

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