TOTVS Connector for AI agents.
11 live capabilities
Manage Brazilian ERP workflows and employee data from a single interface.
Waiting for input…
Why people use TOTVS
Managing Brazilian ERP Workflows with the TOTVS
This Connector changes that by giving your AI agent a direct line into all three ecosystems. You can ask a single question and get a consolidated answer about your employees, payments, or active processes. You get a unified view of your enterprise data without leaving your chat interface.
What Vinkius changes
You get a unified way to manage complex Brazilian ERP data through natural language.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
HR Audit and Staff Overview
An HR manager asks the agent to list all employees and then requests the detailed profile of a specific worker to check their job title.
- Real-world use case 02
Monthly Finance Reconciliation
A controller asks for a summary of all pending payments and then asks the agent to list all receipts from the previous month.
- Real-world use case 03
Workflow Bottleneck Resolution
A manager sees a stuck purchase requisition in Fluig and asks the agent to move it to the next state immediately.
Complete set · 11capabilities
The complete TOTVS capability set.
These are the exact actions your AI can choose when you ask it to work with TOTVS.
01—04
4 capabilities in this set.
Part of 11 available through TOTVS.
- 01 Capability
Get available services
See which RM DataServers are currently available for your queries. This helps you know which data sources your agent can reach.
- 02 Capability
Get employee details
Pull a full profile for a specific worker from the HR system. Use this to get contact info or job titles quickly.
- 03 Capability
Get process request
Fetch the current status and details of a specific Fluig process. This shows you exactly where a request is in the queue.
- 04 Capability
Get rm data
Retrieve a specific record from a designated RM DataServer. It's the fastest way to query individual records in the RM system.
05—08
4 capabilities in this set.
Part of 11 available through TOTVS.
- 05 Capability
List companies
Get a full list of all companies and branches in Protheus. This helps you see the full scope of your organization's structure.
- 06 Capability
List documents
See all files currently stored in the Fluig ECM. Use this to find specific records without digging through folders.
- 07 Capability
List employees
Pull a list of all staff members from the HR module. This is great for getting a quick headcount or overview of your team.
- 08 Capability
List payments
View all accounts payable records for your finance team. It gives you a clear list of what needs to be paid.
09—11
3 capabilities in this set.
Part of 11 available through TOTVS.
- 09 Capability
List processes
See every active BPM process currently running in Fluig. Use this to monitor all ongoing workflows at once.
- 10 Capability
List receipts
View all accounts receivable records to track incoming money. This helps you see which customers still owe a balance.
- 11 Capability
Move process request
Push a Fluig process request to its next state in the workflow. This lets your agent advance a request without manual clicking.
Set up in minutes
One URL. Then ask TOTVS to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TOTVS from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TOTVS, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TOTVS for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TOTVS URL.
- Step 03
Save and start
Save the connection and enable TOTVS in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"totvs": {
"url": "https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TOTVS
Open Agent mode in chat and ask: "Using TOTVS, help me...". 11 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"totvs": {
"url": "https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TOTVS
Ask Copilot: "Using TOTVS, help me...". 11 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"totvs": {
"url": "https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TOTVS
Open Cascade and ask: "Using TOTVS, help me...". 11 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"totvs": {
"url": "https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TOTVS
Ask Cline: "Using TOTVS, help me...". 11 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add totvs --transport http "https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TOTVS
Ask Claude: "Using TOTVS, show me...". 11 tools are ready
Where the request belongs
Work TOTVS can move forward.
This is for the HR and finance professionals who spend their days buried in Brazilian ERP systems. If you're tired of hunting for employee files or manual payment logs, this is your solution.
HR Business Partner
They use this on Tuesday afternoons to pull staff lists and check leave status without opening a single browser tab.
Finance Team Member
They use this to quickly summarize accounts payable and find missing receipts for monthly reports.
Process Analyst
They use this to identify bottlenecks in Fluig workflows and move pending requests forward with a quick command.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsFactorial
Modernize HR operations with time-off management, payroll processing, and performance reviews that employees actually enjoy using.
Workday
Manage workers, payroll data, org structures, and HR workflows on Workday. the enterprise HCM platform.
UKG Pro Workforce Management
Manage schedules, timesheets, accruals, and time-off requests via UKG Pro WFM.
Talexio
Manage HR and payroll for Mediterranean businesses with employee onboarding, leave tracking, and local compliance built in.
Gusto
Manage employees, run payroll, view benefits and time-off policies. HR automation for AI agents.
Oyster
Manage global HR, payroll, and compliance via Oyster. list engagements, track expenses, and manage time-off requests directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep TOTVS connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TOTVS.
The practical details behind the request, access and result.
Can the TOTVS MCP connect to my Protheus environment?
Yes, it connects directly to your Protheus, RM, and Fluig instances to pull data and manage workflows.
How do I use the TOTVS MCP for HR tasks?
You can ask your agent to list all employees or pull specific profile details to quickly handle HR requests.
Can this help with my Fluig business processes?
Yes, it allows your agent to track active processes and move requests to the next state automatically.
Does the TOTVS MCP handle my financial data?
It can list both accounts payable and accounts receivable, letting you monitor payments and receipts easily.
Is the TOTVS MCP compatible with my AI client?
It works with any MCP-compatible client like Claude, Cursor, or Windsurf.
How do I set up the TOTVS MCP?
You'll need your TOTVS Portal credentials and the Base URL from your ERP's API settings to connect.
Which TOTVS systems are compatible with this Connector?
This Connector is designed to work with standard REST APIs from Protheus, RM, and Fluig. Ensure your specific instance has the relevant API modules enabled.
How do I find my TOTVS Base URL?
The Base URL is the address of your ERP or Fluig web service (e.g., https://erp.mycompany.com:8080/rest). You can find this in your system's technical documentation or environment settings.
Can I automatically advance a Fluig process request?
Yes! Use the advance_process capability with the specific Process Instance ID. Your agent will trigger the workflow transition based on the logic defined in Fluig.
Which TOTVS systems are compatible with this MCP?
This MCP is designed to work with standard REST APIs from Protheus, RM, and Fluig. Ensure your specific instance has the relevant API modules enabled.
One connection away
Give your agent a direct line to TOTVS.
Connect TOTVS once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available