MCP Troubleshooting

MCP guide

Diagnose common VauPrime MCP connection, authorization, organization-scope and tool-selection issues without exposing backend internals.

What this guide covers

Check service availability

Protected tool asks for authorization

Organization-scoped tool cannot continue

Customer or ledger selection is ambiguous

Quick facts

ProductVauPrime MCP

ProtocolModel Context Protocol

TransportStreamable HTTP

AccessRead-only tools

Purpose-limited access: VauPrime MCP is designed for authorized, read-only accounting context and minimized structured responses.

01

Check service availability

Use get_vauprime_status or GET https://mcp.vauprime.com/api/health to confirm that the public MCP service is reachable.

02

Protected tool asks for authorization

Complete the VauPrime OAuth flow in the MCP client. Protected business tools cannot run as an anonymous user.

03

Organization-scoped tool cannot continue

Call get_organizations first and use an organization id returned for the connected account. Do not guess organization ids.

04

Customer or ledger selection is ambiguous

Use search_customers or a more specific account_name before requesting detailed customer or ledger data.

05

Test with MCP Inspector

For development, the MCP Inspector can connect using Streamable HTTP. After authorization, call get_organizations and then a scoped tool to verify structured outputs.

Related MCP guides

Continue through the connected VauPrime MCP workflow.

Connect an AI Agent or MCP Client

Connect an MCP-compatible AI agent or client to the production VauPrime MCP endpoint and complete the normal authorization flow.

OAuth, Authentication & Organization Authorization

Learn how VauPrime MCP verifies the connected account and separately checks access to each organization before reading business data.

Privacy & Data Minimization

Understand the privacy controls used by VauPrime MCP to keep AI-agent responses purpose-limited and avoid unnecessary personal, internal and diagnostic data exposure.