Set up MCP Server Praxis Desk Kasse

Connect an external application to the Offisy MCP Server to access your practice data.

Prerequisites

• You have created an API token.
• The target application supports the MCP protocol (e.g. Claude Code, Claude Desktop, Cursor).

Set up Claude Code

1. Open the file ~/.claude/settings.json or use the command in your terminal.
2. Add the following configuration:

{
  "mcpServers": {
    "offisy": {
      "url": "https://my.offisy.at/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Or via terminal:

claude mcp add-json offisy '{"url":"https://my.offisy.at/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

3. Replace YOUR_TOKEN with your copied API token.

Note: Claude Code uses Streamable HTTP Transport and connects directly via URL.

Set up Claude Desktop

1. Open Claude Desktop and go to Settings > Developer > Edit configuration.
2. Add the following configuration:

{
  "mcpServers": {
    "offisy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://my.offisy.at/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

3. Replace YOUR_TOKEN with your copied API token.

Note: Claude Desktop requires Node.js on your machine, as mcp-remote is used as a stdio proxy.

Other applications (Cursor, Windsurf)

The configuration depends on the specific application. In any case you need:

• MCP Server URL: https://my.offisy.at/mcp
• Authorization header: Bearer YOUR_TOKEN

Check your application's documentation to see whether it supports Streamable HTTP or stdio as transport.

Setup via Offisy

You can also find the configuration examples directly in Offisy:

1. Open Settings > MCP API Tokens.
2. Click Setup.
3. Choose your application (Claude Code or Claude Desktop).
4. Copy the displayed configuration.

Related articles

• Create API token
• Manage API tokens