AverbePorto-MCP

AverbePorto-MCP

🌟 概要

AverbePorto-MCP は、AverbePorto プラットフォームとの連携を可能にする MCP（Model Context Protocol）サーバーです。AI（人工知能）ツールを通じて、認証サービスや書類送信サービスに簡単にアクセスできます。

🌐 Web システムへのアクセス

1. https://www.averbeporto.com.br にアクセスします
2. ユーザー認証情報でログインします
3. プラットフォームでは、次の操作ができます：
   • ユーザー登録で API 認証情報を生成する
   • XML 書類を送信する
   • ANTT プロトコルを照会する
   • 貨物保険の登録内容を確認、管理する

🤖 AI ツールで MCP サーバーを利用する

Smithery からのインストール

Smithery を使って、Claude Desktop 用の averbeporto-mcp を自動的にインストールします：

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

Claude Desktop

1. ファイル %APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（MacOS）を編集し、次の設定を追加します：

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

2. 会話を開始すると、設定に基づいて MCP サーバーが自動的に起動します。

Cursor、Roo Code など

1. プロジェクト内に .cursor/mcp.json や .roo/mcp.json などのファイルを作成し、次の設定を追加します：

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

2. 会話を開始すると、設定に基づいて MCP サーバーが自動的に起動します。

Github Copilot

1. エディターで Github Copilot を有効にした状態で、.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 から認証情報を求められ、安全に保存されます。
3. Copilot は MCP コマンドを認識し、次の操作について状況に応じた提案を行います：
   • API 認証
   • XML 書類のアップロード
   • ANTT プロトコルの照会
4. 認証情報は API 呼び出しに自動的に挿入されます。

📚 AI が利用できるツール

AverbePorto-MCP では、次のツールを利用できます：

• login：プラットフォームでの認証

  • パラメーター：user、pass
  • 戻り値：sessionId

• upload：書類の送信

  • パラメーター：sessionId、filePath、recipient（任意）、version（任意）
  • 戻り値：uploadId

• consultProtocol：キーによるプロトコルの照会、またはその逆

  • パラメーター：sessionId、keys、protocols、outputFormat、download、delimiter
  • 出力形式：json、xml、csv

• retrieveDocument：送信済み書類の照会

  • パラメーター：
    • sessionId：ログイン時に取得したセッション ID。
    • modDoc：書類の種類（例：DI、MDF-e、CT-e、NF-e、Minuta CT-e）。
    • dtStart と dtLimit：開始日と終了日。形式は YYYY-MM-DD。
    • dtType：日付の種類（Update、Emission、Send）。既定値は Send。
    • 任意のフィルター：numDoc、emit、rem、exped、receb、dest、toma、importador、representante、prot、taxId。
    • ページネーション：page、start、limit。
    • その他：relation、modal、valid。

• decomposeKey：分析用のキー分解

  • パラメーター：
    • key：NF-e、CT-e、または MDF-e 用の 44 桁のアクセスキー。

🔒 セキュリティ

• ユーザー登録モジュールで生成した API 認証情報を使用してください
• 認証情報を安全に保管してください
• sessionId を共有しないでください
• 常に安全な接続を使用してください
• MCP サーバーを最新の状態に保ってください