How to Use the Alegra MCP in Claude Code

Q: How do I configure Alegra with Claude Code?

Run claude mcp add --transport http alegra -- . Make sure all flags come before the server name.

Q: Does the CLI support inventory updates?

The current tools focus on reading data via listinventoryitems and getitemdetails. You can use these to audit stock levels across your Latin American warehouses.

Q: How do I view Alegra invoice details in Claude Code?

Ask the agent for a specific record. It fires getinvoicedetails and formats the output directly in your terminal window.

Manage LATAM accounting from your terminal. Claude Code executes Alegra MCP tasks headlessly for CI/CD and cron jobs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alegra MCP to Claude Code

Create your Vinkius account to connect Alegra to Claude Code 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 Alegra with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Alegra MCP Server Operations

Nobody wants to open a browser just to check an invoice status. Terminal execution lets you pipe financial data directly into your existing command-line tools. You run a quick prompt. The agent calls `list_invoices` or `list_payments`, parses the JSON, and spits out exactly the fields you asked for.

Automated Financial CI/CD Pipelines

Running reconciliation by hand wastes time. You can embed this connection right into your GitHub Actions or nightly cron jobs. A shell script triggers Claude Code to run `list_estimates` and `list_inventory_items`. The agent compares the values and writes a summary report to your logging system.

Batch Contact Processing

Migrating supplier lists from legacy databases requires precision. Your CLI agent handles the heavy lifting without a graphical interface slowing things down. By looping through `list_contacts` and triggering `create_contact` for missing entries, it synchronizes your directories. You just check the stdout logs when it finishes.

Setup guide

Set up Alegra MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see alegra-extended-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Alegra transactions." It will automatically discover and invoke the available Alegra tools.

Terminal

claude mcp add --transport http alegra-extended-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Alegra MCP

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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "alegra-extended-mcp": {
      "type": "url",
      "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 Alegra. 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 Alegra 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 Alegra MCP in Claude Code

Run `claude mcp add --transport http alegra -- `. Make sure all flags come before the server name.

Yes, headless execution makes this trivial. Set up a scheduled task that tells the agent to fetch `get_company_info` or `list_payments` and pipe the results to a file.

The current tools focus on reading data via `list_inventory_items` and `get_item_details`. You can use these to audit stock levels across your Latin American warehouses.

Ask the agent for a specific record. It fires `get_invoice_details` and formats the output directly in your terminal window.

Terminal execution means no browser extensions intercepting your traffic. Your Latin American billing contacts and estimate amounts hit a stateless Vinkius endpoint that retains absolutely nothing.

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