AverbePorto-MCP

Se integra con la plataforma AverbePorto para autenticación y envío de documentos mediante herramientas de IA.

GitHubPrueba este MCPPatrocinado

Documentación

AverbePorto-MCP

smithery badge

🌟 Acerca de

AverbePorto-MCP es un servidor MCP (Model Context Protocol) que permite la integración con la plataforma AverbePorto, facilitando el acceso a los servicios de autenticación y envío de documentos a través de herramientas de IA (Inteligencia Artificial).

🌐 Accediendo al Sistema Web

  1. Acceda a https://www.averbeporto.com.br
  2. Inicie sesión con sus credenciales de usuario
  3. En la plataforma, usted podrá:
    • Generar Credenciales de API en Registro de Usuario
    • Realizar el envío de documentos XML
    • Consultar protocolos ANTT
    • Acompañar y gestionar sus averbaciones de seguros de carga

🤖 Utilizando el Servidor MCP con Herramientas de IA

Instalación mediante Smithery

Para instalar averbeporto-mcp para Claude Desktop automáticamente vía Smithery:

npx -y @smithery/cli install @GHSix/averbeporto-mcp --client claude

Claude Desktop

  1. Edite el archivo %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (MacOS) y agregue la siguiente configuración: 
     {
   "mcpServers": {
     "AverbePorto-MCP": {
       "command": "node",
       "args": ["/caminho/para/AverbePorto-MCP/build/index.js"]
     }
   }
 }
  2. Al iniciar la conversación, el servidor MCP se iniciará automáticamente según la configuración.

Cursor, Roo Code y otros

  1. Cree un archivo como .cursor/mcp.json o .roo/mcp.json en su proyecto con la siguiente configuración: 
     {
   "mcpServers": {
     "AverbePorto-MCP": {
       "command": "node",
       "args": ["/caminho/para/AverbePorto-MCP/build/index.js"],
       "disabled": false,
       "alwaysAllow": [
         "login",
         "consultProtocol",
         "upload",
         "retrieveDocument",
         "decomposeKey"
       ]
     }
   }
 }
  2. Al iniciar la conversación, el servidor MCP se iniciará automáticamente según la configuración.

Github Copilot

  1. Con Github Copilot activo en su editor, cree el archivo .vscode/mcp.json: 
    {
  "inputs": [
    {
      "type": "promptString",
      "id": "averbeporto-user",
      "description": "AverbePorto API Username"
    },
    {
      "type": "promptString",
      "id": "averbeporto-pass",
      "description": "AverbePorto API Password",
      "password": true
    }
  ],
  "servers": {
    "AverbePorto-MCP": {
      "command": "node",
      "args": ["/caminho/para/AverbePorto-MCP/build/index.js"],
      "env": {
        "AVERBEPORTO_USER": "${input:averbeporto-user}",
        "AVERBEPORTO_PASS": "${input:averbeporto-pass}"
      }
    }
  }
}
  2. VS Code solicitará sus credenciales en la primera ejecución y las almacenará de forma segura.
  3. Copilot reconocerá los comandos MCP y ofrecerá sugerencias contextualizadas para:
    • Autenticación en la API
    • Carga de documentos XML
    • Consulta de protocolos ANTT
  4. Las credenciales se inyectarán automáticamente en las llamadas a la API.

📚 Herramientas Disponibles para la IA

AverbePorto-MCP ofrece las siguientes herramientas:

  • login: Autenticación en la plataforma

    • Parámetros: user, pass
    • Retorna: sessionId

  • upload: Envío de documentos

    • Parámetros: sessionId, filePath, recipient (opcional), version (opcional)
    • Retorna: uploadId

  • consultProtocol: Consulta de protocolos por clave o viceversa

    • Parámetros: sessionId, keys, protocols, outputFormat, download, delimiter
    • Formatos de salida: json, xml, csv

  • retrieveDocument: Consulta de documentos enviados

    • Parámetros:
      • sessionId: ID de sesión obtenido en el inicio de sesión.
      • modDoc: Tipo de documento (p. ej., DI, MDF-e, CT-e, NF-e, Minuta CT-e).
      • dtStart y dtLimit: Fechas de inicio y fin en el formato YYYY-MM-DD.
      • dtType: Tipo de fecha (Update, Emission, Send), el valor predeterminado es Send.
      • Filtros opcionales: numDoc, emit, rem, exped, receb, dest, toma, importador, representante, prot, taxId.
      • Paginación: page, start, limit.
      • Otros: relation, modal, valid.

  • decomposeKey: Descomposición de claves para análisis

    • Parámetros:
      • key: Clave de acceso de 44 dígitos para NF-e, CT-e o MDF-e.

🔒 Seguridad

  • Utilice las credenciales de API generadas en el módulo Registro de Usuario
  • Mantenga sus credenciales seguras
  • No comparta su sessionId
  • Utilice siempre conexiones seguras
  • Mantenga el servidor MCP actualizado