Servidor MCP de DeveuWeb

Introducción

El servidor MCP (Model Context Protocol) de DeveuWeb expone los datos de tu organización a asistentes de IA de forma segura y controlada. Cada token actúa en nombre de su creador, con sus permisos reales y limitado a los recursos y scopes que tú elijas.

El transporte es Streamable HTTP (JSON-RPC 2.0 sobre POST). No hay estado de sesión: cada petición se autentica de forma independiente.

Requisitos

• Un plan con el servidor MCP incluido.
• Autenticación en dos pasos (2FA) activada en tu cuenta — se verifica en cada petición.
• Rol de administrador o propietario en la organización para generar tokens.

Cómo conectar

Hay tres formas de conectar un cliente MCP. La recomendada es el conector OAuth: no copias ningún token y el acceso se renueva solo.

{
  "mcpServers": {
    "deveuweb": {
      "url": "https://app.deveuweb.com/mcp",
      "headers": {
        "Authorization": "Bearer dvw_mcp_..."
      }
    }
  }
}

{
  "mcpServers": {
    "deveuweb": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://app.deveuweb.com/mcp",
        "--header", "Authorization: Bearer dvw_mcp_..."
      ]
    }
  }
}

Gestiona tus tokens y conexiones desde el panel de tu organización.

Autenticación y scopes

Tokens

Los tokens tienen el formato dvw_mcp_… y se muestran una sola vez al crearlos — en la base de datos solo se guarda su hash SHA-256, así que no se pueden recuperar después. Se revocan al instante desde el panel y caducan según tu plan.

Cada token actúa como su creador con su rol vigente: si pierde el rol de administrador o desactiva el 2FA, todos sus tokens dejan de funcionar inmediatamente.

Scopes

Cada token lleva una lista de scopes con el formato read:invoices · write:expenses. La lectura desbloquea las tools .list y .get; la escritura, .create y .update. Una llamada a una tool fuera de los scopes del token devuelve el error -32003.

OAuth 2.1

Para el conector OAuth, el servidor publica su metadata en /.well-known/oauth-authorization-server y soporta registro dinámico de clientes (DCR). Los access tokens duran 60 minutos y se renuevan automáticamente con el refresh token.

Límites

• Rate limit: 60 peticiones por minuto por token (configurable por plan o token). Por encima, HTTP 429.
• Llamadas al mes: según tu plan; el contador se muestra en el panel MCP de tu organización.
• Las tools .list devuelven 25 resultados por defecto y 100 como máximo (parámetro limit).
• Adjuntos (p. ej. recibos de gastos): PDF, JPG o PNG en base64, máximo 5 MB.

Recursos y tools

Esta referencia se genera automáticamente del registro del servidor: siempre refleja exactamente lo que el MCP expone. Los nombres y descripciones técnicas se muestran en inglés.

Ejemplos

Peticiones reales con curl. Sustituye $TOKEN por tu token.

curl -X POST https://app.deveuweb.com/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -X POST https://app.deveuweb.com/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "invoices.list",
      "arguments": { "search": "202606", "limit": 10 }
    }
  }'

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      { "type": "text", "text": "[ { \"id\": 12, \"code\": \"2026060001\", \"status\": \"paid\", \"total\": \"1590.31\", ... } ]" }
    ]
  },
  "id": 1
}

curl -X POST https://app.deveuweb.com/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "expenses.create",
      "arguments": {
        "date": "2026-06-08",
        "concept": "Spotify Premium",
        "category": "software",
        "subtotal": 4.96,
        "iva_percentage": 21,
        "irpf_percentage": 0,
        "provider": "Spotify AB",
        "attachment_base64": "JVBERi0xLjcK...",
        "attachment_filename": "receipt.pdf"
      }
    }
  }'

Errores