AverbePorto-MCP
About
Integrates with the AverbePorto platform for authentication and document submission using AI tools.
Details
- Author
- GHSix
- Downloads
- 132
- Categories
- Other, Cloud Service, Infrastructure
Jump to
- Authenticate on the AverbePorto platform via the login tool
- Upload XML documents with optional recipient and version
- Consult ANTT protocols by key or vice versa
- Retrieve sent documents with various filters and pagination
- Decompose 44-digit access keys for NF-e, CT-e, or MDF-e
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AverbePorto-MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery using npx -y @smithery/cli install @GHSix/averbeporto-mcp --client claude, or configure manually by adding the server to your MCP client's configuration file (Claude Desktop, Cursor, Roo Code, or GitHub Copilot) with the path to the build/index.js script and your AverbePorto API credentials.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"averbeporto-mcp": {
"AverbePorto-MCP": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@GHSix/averbeporto-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"AverbePorto-MCP": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@GHSix/averbeporto-mcp",
"--client",
"claude"
]
}
}AverbePorto-MCP
🌟 Sobre
O AverbePorto-MCP é um servidor MCP (Model Context Protocol) que permite a integração com a plataforma AverbePorto, facilitando o acesso aos serviços de autenticação e envio de documentos através de ferramentas de IA (Inteligência Artificial).🌐 Acessando o Sistema Web
1. Acesse https://www.averbeporto.com.br
2. Faça login com suas credenciais de usuário
3. Na plataforma, você poderá:
- Gerar Credenciais de API em Cadastro do Usuário
- Realizar envio de documentos XML
- Consultar protocolos ANTT
- Acompanhar e gerenciar suas averbações de seguros de carga
🤖 Utilizando o MCP Server com Ferramentas de IA
Instalação pelo Smithery
Para instalar averbeporto-mcp para Claude Desktop automaticamente via Smithery:
npx -y @smithery/cli install @GHSix/averbeporto-mcp --client claude
Claude Desktop
1. Edite o arquivo%APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/Library/Application Support/Claude/claude_desktop_config.json (MacOS) e adicione a seguinte configuração:
{
"mcpServers": {
"AverbePorto-MCP": {
"command": "node",
"args": ["/caminho/para/AverbePorto-MCP/build/index.js"]
}
}
}
Cursor, Roo Code e outros
1. Crie um arquivo como.cursor/mcp.json ou .roo/mcp.json em seu projeto com a seguinte configuração:
{
"mcpServers": {
"AverbePorto-MCP": {
"command": "node",
"args": ["/caminho/para/AverbePorto-MCP/build/index.js"],
"disabled": false,
"alwaysAllow": [
"login",
"consultProtocol",
"upload",
"retrieveDocument",
"decomposeKey"
]
}
}
}
Github Copilot
1. Com o Github Copilot ativo em seu editor, crie o arquivo.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}"
}
}
}
}
📚 Ferramentas Disponíveis para a IA
O AverbePorto-MCP oferece as seguintes ferramentas:
- login: Autenticação na plataforma
- Parâmetros: user, pass
- Retorna: sessionId
- upload: Envio de documentos
- Parâmetros: sessionId, filePath, recipient (opcional), version (opcional)
- Retorna: uploadId
- consultProtocol: Consulta de protocolos por chave ou vice-versa
- Parâmetros: sessionId, keys, protocols, outputFormat, download, delimiter
- Formatos de saída: json, xml, csv
- retrieveDocument: Consulta de documentos enviados
- Parâmetros:
- sessionId: ID da sessão obtido no login.
- modDoc: Tipo de documento (e.g., DI, MDF-e, CT-e, NF-e, Minuta CT-e).
- dtStart e dtLimit: Datas de início e fim no formato YYYY-MM-DD.
- dtType: Tipo de data (Update, Emission, Send), padrão é Send.
- Filtros opcionais: numDoc, emit, rem, exped, receb, dest, toma, importador, representante, prot, taxId.
- Paginação: page, start, limit.
- Outros: relation, modal, valid.
- decomposeKey: Decomposição de chaves para análise
- Parâmetros:
- key: Chave de acesso de 44 dígitos para NF-e, CT-e ou MDF-e.
🔒 Segurança
- Utilize as credenciais de API geradas no módulo Cadastro do Usuário - Mantenha suas credenciais em segurança - Não compartilhe seusessionId
- Utilize sempre conexões seguras
- Mantenha o servidor MCP atualizadoSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
