How to Use the Focus Varejo MCP in Claude

Q: Can I use Focus Varejo in Claude Desktop to cancel invoices?

Yes, you can run cancelnfce to void incorrect documents. Just ask your agent to cancel the specific invoice, and it will execute the call against the API on your behalf.

Emit tax documents and manifest invoices directly from your Claude Desktop interface using Focus Varejo.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Focus Varejo MCP to Claude Desktop

Create your Vinkius account to connect Focus Varejo to Claude Desktop 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 Varejo with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate retail tax document issuance

Trigger `emit_nfce` or `emit_nfcom` inside your chat session to handle retail sales and telecom invoices. You get the API response immediately, letting you verify document status before your customer even leaves the counter. This workflow removes manual entry errors. Your agent manages the entire lifecycle, using `consult_nfce` or `consult_nfcom` to double-check that every submission reached the tax authority.

Track inbound logistics and receipts

Use `manifest_nfe` to acknowledge inbound invoices or `manifest_cte` for freight documents without switching tabs. Your agent processes these states directly, ensuring you stay compliant with local regulatory requirements. It handles the heavy lifting of document confirmation. You keep your focus on store operations while the server logs the necessary acknowledgments in the background.

Manage incoming service invoices

Pull a list of your company's received NFS-e using `list_received_nfse` to keep your accounting records current. This tool gives you a clear view of your service obligations without digging through email or external portals. Everything stays organized within your chat. By calling the tool periodically, you ensure that no service invoice slips through the cracks during your monthly reconciliation.

Setup guide

Set up Focus Varejo MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Focus Varejo MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Focus Varejo MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under focus-varejo-mcp.

json

{
  "mcpServers": {
    "focus-varejo-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 Varejo 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 Varejo MCP in Claude Desktop

It runs as a local subprocess, connecting your agent to the tax API via the MCP standard. You configure the server in your local JSON settings file, and the tools appear as a hammer icon in your input bar.

Yes, you can run `cancel_nfce` to void incorrect documents. Just ask your agent to cancel the specific invoice, and it will execute the call against the API on your behalf.

Your API keys and tax data stay local to your machine. The server only communicates with the official API endpoints, and no sensitive information is shared with third parties.

The server returns the specific error code from the API. You can read this response directly in the chat to understand exactly why the rejection occurred.

It needs a connection to reach the tax authority's servers for document processing. Without network access, the tools cannot verify or emit any fiscal data.

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