AverbePorto MCP Server: Streamlining Document Management with AI on UBOS

The AverbePorto MCP (Model Context Protocol) Server is a crucial integration component that bridges the gap between the AverbePorto platform and various AI tools. By providing a standardized interface, the MCP Server simplifies the process of accessing AverbePorto’s authentication and document submission services through AI agents, enhancing efficiency and automation. This document provides a comprehensive overview of the AverbePorto MCP Server, its functionalities, use cases, and integration methods.

What is AverbePorto?

AverbePorto (https://www.averbeporto.com.br) is a platform specializing in document management and authentication, particularly for transportation and logistics companies in Brazil. It offers services such as:

• Generating API credentials
• Submitting XML documents
• Consulting ANTT (National Land Transportation Agency) protocols
• Managing cargo insurance endorsements

Key Features of AverbePorto-MCP

The AverbePorto-MCP server acts as an intermediary, allowing AI models to interact with the AverbePorto platform programmatically. Here’s a breakdown of its key features:

• Authentication: Facilitates secure login to the AverbePorto platform, providing a sessionId for subsequent API calls.
• Document Upload: Enables the uploading of documents in XML format, essential for various compliance and regulatory processes.
• Protocol Consultation: Allows querying ANTT protocols using keys or protocol numbers, providing essential information for logistics operations.
• Document Retrieval: Enables retrieving documents based on various parameters, including document type, date ranges, and other filters.
• Key Decomposition: Decomposes access keys for NF-e, CT-e, and MDF-e documents, enabling detailed analysis and data extraction.

Use Cases

The AverbePorto MCP Server unlocks numerous automation possibilities by integrating with AI agents. Here are some prominent use cases:

• Automated Document Processing: AI agents can automatically upload and process transportation documents, reducing manual data entry and minimizing errors. Imagine an AI agent monitoring incoming emails for XML invoices. Upon receipt, the agent uses the AverbePorto-MCP to automatically log in, upload the invoice, and verify its acceptance with consultProtocol. This dramatically reduces processing time and frees up human staff for more strategic tasks.
• Compliance Monitoring: AI-powered systems can continuously monitor ANTT protocols, ensuring compliance with regulations and flagging potential issues proactively. An AI-powered compliance dashboard can use the consultProtocol functionality to regularly check the status of all submitted documents, alerting administrators to any discrepancies or pending actions.
• Data Extraction and Analysis: AI models can extract relevant information from transportation documents and analyze it for insights, such as identifying trends in cargo insurance endorsements or optimizing logistics routes. By decomposing keys with the decomposeKey function, an AI can automatically categorize and analyze different types of electronic invoices, providing valuable insights into shipping patterns and tax implications.
• AI-Driven Customer Service: Integrate with chatbots to provide instant answers to customer inquiries regarding document status, protocol information, and other relevant details. A customer service chatbot can use the retrieveDocument and consultProtocol functions to quickly provide customers with the status of their document submissions or insurance endorsements, improving customer satisfaction and reducing support costs.
• Fraud Detection: The decomposeKey functionality allows AI agents to analyze document keys for inconsistencies or anomalies, potentially identifying fraudulent activities or errors in data entry. An AI-powered fraud detection system can compare the decomposed key information with other data sources, such as shipping manifests and GPS data, to identify suspicious patterns that may indicate fraudulent activity.

Integrating AverbePorto-MCP with AI Tools

The AverbePorto-MCP Server is designed to be compatible with various AI development platforms and tools. The following sections outline the integration process with popular options such as Claude Desktop, Cursor, Roo Code, and GitHub Copilot.

Integration with Claude Desktop

Claude Desktop (https://claude.ai/download) is a popular AI development environment. To integrate AverbePorto-MCP with Claude Desktop:

1. Edit Configuration: Locate and edit the Claude Desktop configuration file (%APPDATA%Claudeclaude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS).
2. Add MCP Server Configuration: Add the following JSON snippet to the mcpServers section:

{ “mcpServers”: { “AverbePorto-MCP”: { “command”: “node”, “args”: [“/caminho/para/AverbePorto-MCP/build/index.js”] } } }

Replace `/caminho/para/AverbePorto-MCP/build/index.js` with the actual path to the AverbePorto-MCP server's entry point.

3. Restart Claude Desktop: Upon restarting, the MCP server will automatically launch based on the configuration.

Integration with Cursor and Roo Code

Cursor (https://www.cursor.com/) and Roo Code (https://roocode.com/) are AI-powered code editors. To integrate AverbePorto-MCP with these editors:

1. Create MCP Configuration File: Create a file named .cursor/mcp.json (for Cursor) or .roo/mcp.json (for Roo Code) in your project’s root directory.
2. Add MCP Server Configuration: Add the following JSON snippet to the file:

{ “mcpServers”: { “AverbePorto-MCP”: { “command”: “node”, “args”: [“/caminho/para/AverbePorto-MCP/build/index.js”], “disabled”: false, “alwaysAllow”: [ “login”, “consultProtocol”, “upload”, “retrieveDocument”, “decomposeKey” ] } } }

Replace `/caminho/para/AverbePorto-MCP/build/index.js` with the actual path to the AverbePorto-MCP server's entry point.  The `alwaysAllow` array lists the MCP functions that should be automatically approved for use by the AI agent.

3. Start Conversation: Upon starting a conversation in Cursor or Roo Code, the MCP server will be automatically launched based on the configuration.

Integration with GitHub Copilot

GitHub Copilot (https://github.com/features/copilot) is an AI pair programmer. To integrate AverbePorto-MCP with GitHub Copilot:

1. Create MCP Configuration File: Create a file named .vscode/mcp.json in your project’s root directory.
2. Add MCP Server Configuration: Add the following JSON snippet to the file:

{ “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}” } } } }

Replace `/caminho/para/AverbePorto-MCP/build/index.js` with the actual path to the AverbePorto-MCP server's entry point. This configuration also defines input prompts for the AverbePorto API username and password.

3. Provide Credentials: VS Code will prompt you for your AverbePorto API credentials upon the first execution. These credentials will be securely stored.

Copilot will then recognize the MCP commands and offer contextual suggestions for authentication, document upload, and protocol consultation, automatically injecting the credentials into the API calls.

Available Tools for AI

The AverbePorto-MCP Server provides the following tools for AI agents:

• login: Authenticates with the AverbePorto platform.
  • Parameters: user, pass
  • Returns: sessionId
• upload: Uploads documents to the AverbePorto platform.
  • Parameters: sessionId, filePath, recipient (optional), version (optional)
  • Returns: uploadId
• consultProtocol: Consults protocols by key or vice-versa.
  • Parameters: sessionId, keys, protocols, outputFormat, download, delimiter
  • Output Formats: json, xml, csv
• retrieveDocument: Retrieves documents based on various criteria.
  • Parameters: sessionId, modDoc, dtStart, dtLimit, dtType, and various optional filters.
• decomposeKey: Decomposes document keys for analysis.
  • Parameters: key (44-digit access key)

Security Considerations

Security is paramount when integrating with the AverbePorto platform. Follow these guidelines to ensure a secure integration:

• Use API Credentials: Always use API credentials generated within the AverbePorto platform’s user settings.
• Secure Credentials: Keep your credentials secure and never share your sessionId.
• Secure Connections: Always use secure connections (HTTPS) when communicating with the AverbePorto platform.
• Keep MCP Server Updated: Regularly update the AverbePorto-MCP server to benefit from the latest security patches and improvements.

UBOS: Enhancing AI Agent Development

The AverbePorto-MCP server seamlessly integrates with the UBOS (Unified Business Orchestration System) platform, offering a robust environment for AI agent development and deployment. UBOS is a full-stack AI Agent Development Platform designed to empower businesses across various departments with AI agents. Key features of UBOS include:

• AI Agent Orchestration: UBOS provides tools for designing, building, and managing complex AI agent workflows, streamlining the integration of AI into business processes.
• Enterprise Data Connectivity: UBOS allows AI agents to securely connect with enterprise data sources, ensuring access to the information needed to make informed decisions and automate tasks. This includes seamless integration with the AverbePorto MCP server.
• Custom AI Agent Building: UBOS enables businesses to build custom AI agents tailored to specific needs, leveraging their own LLM models and datasets. This allows for fine-tuning agents to perfectly match the requirements of document management and compliance processes.
• Multi-Agent Systems: UBOS supports the development of multi-agent systems, where multiple AI agents collaborate to achieve complex goals. For example, one agent could be responsible for uploading documents, while another monitors their status and alerts relevant personnel to any issues.

By leveraging UBOS, businesses can fully harness the power of the AverbePorto MCP server to automate document management, ensure compliance, and gain valuable insights from their data. The combination of UBOS and AverbePorto-MCP empowers organizations to build sophisticated AI-driven solutions that transform their operations and drive efficiency.