Skip to main content

MCP Getting Started

This page shows the shortest customer setup: create a token, choose the right hosted endpoint, add it to your MCP client, and verify that the assistant can resolve a VAT ID.

1. Create A Token​

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.

2. Choose The Environment​

EnvironmentMCP endpoint
Productionhttps://mcp.app.optimussoftware.de
Testhttps://mcp.dev.app.optimussoftware.de

Start with the test endpoint when you are checking a new assistant setup. Switch to production only when the assistant should work with production Optimus data.

3. Add Optimus MCP To Your Client​

Use an MCP client that supports hosted Streamable HTTP servers and custom headers.

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>"
      }
    }
  }
}

For test, use:

https://mcp.dev.app.optimussoftware.de

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

4. Verify The Connection​

Ask the assistant:

Use Optimus MCP to resolve VAT ID DE284700631.

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

Example successful result:

DE284700631 is valid.
Resolved company: Optimus Software GmbH
Address: Tal 44, 80331 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.

5. 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 DE284700631 is valid and show the resolved company data.
Use Optimus MCP to find VAT ID candidates for Optimus Software GmbH in Germany at Tal 44, 80331 Munchen.
Use Optimus MCP to validate this supplier record: VAT ID DE284700631, Optimus Software GmbH, Tal 44, 80331 Munchen.

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

Use Optimus MCP for VAT ID lookup and VAT validation.
Use the test endpoint for test workflows and the production endpoint only for production data.
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.