How to Use the Hudu MCP in Claude Code

Q: How do I configure Hudu in Claude Code?

Run claude mcp add --transport http hudu-mcp -- . Make sure you place all transport flags before the server name. Verify the connection with claude mcp list.

Q: Does Claude Code pull all Hudu companies at once?

It depends on the command. The agent typically runs listcompanies to get an overview, then uses getcompany with a specific ID to pull targeted information for a single organization.

Pipe Hudu asset data and passwords directly into your terminal workflows with Claude Code for headless infrastructure automation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hudu MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Hudu MCP Server from the Command Line

The Hudu MCP Server exposes your entire IT knowledge base to your terminal environment. Claude Code runs `list_assets` and `list_networks` to audit infrastructure without ever opening a web browser. You trigger a script, and the agent pulls the current server inventory. It cross-references the live data against your Terraform state files, identifying discrepancies and outputting a clean summary right in your standard output.

Fetch Passwords in Pipelines

The Hudu MCP Server pulls exact deployment secrets directly into your terminal. Claude Code executes `list_passwords` to grab the specific staging or production credentials needed for a run. It filters the results by executing `list_companies` and `get_company` to ensure the correct client context. The agent grabs the vault data, injects it into the immediate shell session, and runs the deployment commands automatically.

Correlate Activity Logs via MCP

The Hudu MCP Server tracks infrastructure changes by pulling recent logs during incident response. Claude Code hits `list_activity_logs` and `list_websites` to track exactly what shifted in your monitored environments before an outage. You pipe an error log into the CLI, and the agent checks the documentation via `list_procedures` to find the official remediation steps. It executes the fix based on the exact parameters defined in your IT manual.

Setup guide

Set up Hudu 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 hudu-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http hudu-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 Hudu 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": {
    "hudu-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 Hudu. 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 Hudu 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 Hudu MCP in Claude Code

Run `claude mcp add --transport http hudu-mcp -- `. Make sure you place all transport flags before the server name. Verify the connection with `claude mcp list`.

No. The available tools are strictly for reading data. Operations like `list_assets` and `list_contacts` pull information into the terminal, but the agent cannot issue delete commands.

You define the API key as an environment variable or pass it via headers during the initial configuration. The CLI stores this securely in `~/.claude.json` for future sessions.

It depends on the command. The agent typically runs `list_companies` to get an overview, then uses `get_company` with a specific ID to pull targeted information for a single organization.

Only the local user running the terminal session. Data pulled via `list_activity_logs` remains strictly within your machine's standard output and the ephemeral memory of the active CLI process.

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