How to Use the Focus NFe MCP in Cline

Q: How does Cline use the Focus NFe MCP server to write invoice integration tests?

Cline calls the emitnfe tool in sandbox mode to get a real SEFAZ response. It then writes Jest or Mocha tests using that exact payload structure, ensuring your test suite matches live API behavior.

Q: Can I download and archive physical XML files with this setup?

Yes. You can instruct the agent to run downloadxml for a specific invoice ID. Cline retrieves the file and saves it directly to your workspace folder.

Let Cline build, test, and run your Brazilian tax workflows inside VS Code using the Focus NFe MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Focus NFe MCP to Cline

Create your Vinkius account to connect Focus NFe to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Focus NFe with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

End-to-End Product Invoice Automation

The `emit_nfe` tool handles the direct generation of Brazilian product invoices within your VS Code editor using this MCP server. Cline uses this tool to test tax calculations and verify SEFAZ compliance during your development cycle. You tell Cline to build an invoice generator, and it writes the code, imports this tool, and runs a test run. It verifies the response payload and updates your database schema to match the returned keys.

Direct Service Invoice Integration

The `emit_nfse` tool issues municipal service invoices across hundreds of Brazilian cities. Cline accesses this tool to build backend routes that handle local tax variations without manual configuration. The agent writes the integration code, triggers a test emission, and checks for validation errors. It handles the municipal differences so you do not have to write custom code for each city.

Document Lifecycle Management and XML Retrieval

The `consult_document` tool checks the current state of any issued invoice directly from your editor. Cline calls this to verify whether SEFAZ approved, rejected, or queued your document. If approved, the agent runs `download_xml` to save the fiscal file to your project assets. If you need to revert a transaction, Cline triggers `cancel_document` to invalidate the tax record instantly.

Setup guide

Set up Focus NFe MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type focus-nfe-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Focus NFe refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "focus-nfe-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Focus NFe. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Focus NFe now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Focus NFe MCP in Cline

Cline calls the `emit_nfe` tool in sandbox mode to get a real SEFAZ response. It then writes Jest or Mocha tests using that exact payload structure, ensuring your test suite matches live API behavior.

Yes. Cline analyzes your customer's location, maps it to the correct municipal rules, and calls `emit_nfse` with the required city-specific fields. It automates the entire mapping logic inside VS Code.

Click the MCP icon in the Cline sidebar and add the server configuration. Cline automatically loads the tool definitions, making them ready for your next prompt.

Yes. You can instruct the agent to run `download_xml` for a specific invoice ID. Cline retrieves the file and saves it directly to your workspace folder.

Yes. Your sensitive XML payloads and corporate tax keys are processed through an isolated environment. Cline communicates directly with the API endpoint, keeping your fiscal data private and secure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript