Skip to main content

MCP Getting Started

This page shows the shortest customer setup: choose the right hosted endpoint, connect with OAuth when your MCP client supports it, and verify that the assistant can resolve a VAT ID.

1. Use The Hosted Endpoint​

The hosted Optimus MCP endpoint is:

https://mcp.app.optimussoftware.de

2. Add Optimus MCP To Your Client​

Use an MCP client that supports hosted Streamable HTTP servers.

OAuth Clients​

For Claude hosted connectors, Claude Code, and other clients that support MCP OAuth discovery, add only the Optimus MCP endpoint:

https://mcp.app.optimussoftware.de

The client discovers the OAuth metadata from the MCP endpoint, registers its own OAuth client dynamically, and sends you through the Optimus sign-in and consent flow. You do not need a fixed client ID and you should not paste an Optimus API token into an OAuth-capable hosted connector.

Approve only the Optimus MCP permissions you expect, such as VAT lookup and validation.

API Token Fallback​

Use this fallback only for MCP clients that cannot sign in with OAuth but can send custom authorization headers.

Create a Personal Access Token in the Optimus web app under Settings > API Interface > API Tokens.

Copy the token immediately. The full secret is shown only once.

Do not paste real tok_optimus_ token values into chat messages, public prompts, screenshots, support tickets, or documentation examples.

Add the Optimus MCP endpoint and configure this authorization header:

Authorization: Bearer <token>

Some MCP clients use JSON configuration. In those clients, the configuration usually looks like this:

{
  "mcpServers": {
    "optimus": {
      "url": "https://mcp.app.optimussoftware.de",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

If your client lets you limit available actions, enable the Optimus VAT lookup and validation actions only.

3. Verify The Connection​

Ask the assistant:

Use Optimus MCP to resolve VAT ID DE329194932.

A successful answer should say whether the VAT ID is valid and show resolved company data when Optimus can provide it.

Example successful result:

DE329194932 is valid.
Resolved company: TL Digital Solutions GmbH
Address: Leopoldstr. 8, 80802 Munchen
Checked at: 2026-04-19T10:17:26.4359867Z

The exact wording depends on your assistant. The important part is that it used Optimus MCP and returned a VAT status.

4. Try A Real Workflow​

After the connection works, try prompts that match how your team will use the assistant:

Use Optimus MCP to check whether DE329194932 is valid and show the resolved company data.
Use Optimus MCP to find VAT ID candidates for TL Digital Solutions GmbH in Germany at Leopoldstr. 8, 80802 Munchen.
Use Optimus MCP to validate this supplier record: VAT ID DE329194932, TL Digital Solutions GmbH, Leopoldstr. 8, 80802 Munchen.

Add a short instruction to your assistant configuration or workspace instructions:

Use Optimus MCP for VAT ID lookup and VAT validation.
Use the configured Optimus MCP endpoint for approved assistant workflows.
Never reveal the Optimus bearer token.
When a validation takes longer, continue the validation until a final result is available.
Summarize results in business language for the user.