Skip to main content
Glama
deenesjakoruzh
vinilana

Spedy NFS-e MCP

by vinilana
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Spedy NFS-e MCP

認証付きMCP Streamable HTTPエンドポイントを通じて、Spedy NFS-eの発行およびステータス操作を公開するInvokta Action Engineです。

このエンジンには3つのケイパビリティが含まれています：

  • openapi.emitir-nfse: NFS-eを作成し、非同期発行のためにキューに登録します。

  • openapi.consultar-nfse: 1件のNFS-eの現在のステータスを読み取ります。

  • openapi.listar-nfse: Spedyのフィルタとページネーションを使用してNFS-eレコードを一覧表示します。

すべてのケイパビリティには認証済みプリンシパルが必要です。Spedyの認証情報はサーバー側に保持され、MCPツールの入力として受け付けられることはありません。

初回実行

npm run check
npm run build
npm run mcp:http

同梱のローカル設定は、http://127.0.0.1:3400/mcp でMCPを提供します。クライアントは Authorization: Bearer <MCP_BEARER_TOKEN> を送信する必要があります。

コミット済みの .env.example と無視されるローカルの .env にはモック値が含まれています。実際のリクエストを行う前に MCP_BEARER_TOKEN と SPEDY_API_KEY を置き換えてください。デフォルトのコネクタターゲットはSpedyのサンドボックスであり、本番環境が暗黙的に選択されることはありません。

Related MCP server: Receita Federal NFS-e: Notas Recebidas MCP

設定

Variable

Purpose

MCP_BEARER_TOKEN

MCP HTTPエンドポイントを保護します。最小32文字です。

SPEDY_API_KEY

コネクタによってサーバー側の X-Api-Key として送信されます。

SPEDY_BASE_URL

Spedy APIのオリジン。通常は https://sandbox-api.spedy.com.br です。/v1 を追加しないでください。

INVOKTA_HTTP_HOST

バインドホスト。デフォルトは 127.0.0.1 です。

INVOKTA_HTTP_PORT

バインドポート。ローカル例では 3400 を使用し、未設定時はアダプタのデフォルトは 3000 です。

発行は非同期です。emitir-nfse の成功結果は、Spedyがリクエストを受け入れ、キューに登録したことを意味します。認可または拒否を確認するには、consultar-nfse またはSpedyのWebhookを使用してください。再試行を冪等にするために、常に安定した integrationId を提供してください。

プロジェクト構成

  • src/capabilities/ はドメインアクションと、その入力、出力、アクセス、実行コントラクトを管理します。

  • src/engine.ts は安定したケイパビリティIDを登録し、エンジン所有の依存関係を提供します。

  • src/direct.ts は最小の実行可能なスモークテストパスです。

  • test/engine.test.ts は公開エンジン境界を通じて動作を検証します。

  • AGENTS.md はプロジェクトの譲れないアーキテクチャと納品ルールを記録しています。

  • .agents/skills/develop-invokta-project/SKILL.md は互換性のあるエージェントに完全な変更ワークフローを提供します。

生成されたケイパビリティのレビュー

  1. AGENTS.md と生成された開発スキルを読んでください。

  2. 必要なドメイン成果に対する失敗するエンジンレベルのテストを追加してください。

  3. src/capabilities/ 配下のモジュールを更新または置き換え、そのリテラルなケイパビリティIDを src/engine.ts に登録してください。

  4. 直接および生成されたアダプタのエントリポイントを同じエクスポートされたエンジンに維持してください。アダプタ内でケイパビリティハンドラを複製しないでください。

  5. npm run check を実行し、デプロイ前にdevtoolsでケイパビリティを確認してください。

対話的に開発する

npm run devtools

エンジンをビルドし、Invokta devtoolsを起動します。通常は http://localhost:4100/ で実行されます。コマンドが出力するURLを開くと、ケイパビリティの閲覧、選択した実行パスを通じたスキーマシード済みJSONからの呼び出し、ライブ呼び出しトレースの追跡、テストIDの切り替え、ドクターレポートの閲覧ができます。ソースの変更は、ホストされたエンジンを自動的に再ビルドして再起動します。

読み取り専用のdevtools診断を実行するには：

npm run devtools:doctor

MCP HTTPの起動

npm run build
npm run mcp:http

サーバーをパッケージ化し、既存のエンドポイントをプローブするには：

npm run deploy:package
npm run deploy:probe -- --url https://engine.example/mcp

デプロイ前に、生成されたすべてのケイパビリティのドメイン上の意味とアクセスルールをレビューしてください。

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • fiscal

    Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.

  • Brazil Invoices (NFS-e nota fiscal de serviço)

    Brazil NFS-e service invoices for AI agents via Focus NFe and NFe.io. Stateless, never stores data.

  • Nota Fiscal

    Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vinilana/nf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server