Model Context Protocol (MCP)

​

Overview

Chift offers an MCP server that exposes the Chift Unified API to any LLM provider supporting the MCP protocol.
This enables you to build AI agents or other AI applications that can access all our integrations through one MCP server.
Our endpoints are exposed as “tools” through the MCP server.

Chift MCP server can be found here.

​

Installation

To be able to use the Chift MCP, the following prerequisites are needed:

• A Chift account with client credentials
• Python 3.11 or higher
• uv

More information can be found here

​

Setup

​

Claude for Desktop

​

Configuration

This is an example of a configuration file for Claude:

{
  "mcpServers": {
    "chift": {
      "command": "/path/to/uv",
      "args": [
        "chift-mcp-server",
        "stdio"
      ],
      "env": {
        "CHIFT_CLIENT_SECRET": "your_client_secret",
        "CHIFT_CLIENT_ID": "your_client_id",
        "CHIFT_ACCOUNT_ID": "your_account_id",
        "CHIFT_URL_BASE": "https://api.chift.eu"
      }
    }
  }
}

​

After Configuration

1. Restart Claude for Desktop
2. You should see a tool icon in the chat input area
3. Click on the tool icon to see the available Chift API tools
4. Start chatting with Claude using the Chift tools

​

Other examples

The MPC server can be accessed by any LLM provider supporting MCP. We have elaborated on several examples (PydanticAI, Copilot, …) here

​

Available tools

The Chift MCP Server dynamically generates tools based on the Chift OpenAPI specification. These tools provide access to various Chift API endpoints and include operations for:

• Retrieving financial data
• Managing your financial connections
• Creating new financial records (invoices, payments, etc.)
• Updating existing records
• …

All our endpoints documented in our api can be accessed through Chift MCP server.

​

Environment variables

The following environment variables are used by the Chift MCP Server:

CHIFT_CLIENT_SECRET: Your Chift client secret
CHIFT_CLIENT_ID: Your Chift client ID
CHIFT_ACCOUNT_ID: Your Chift account ID
CHIFT_URL_BASE: Chift API URL (default: https://api.chift.eu)
CHIFT_FUNCTION_CONFIG: JSON string to configure which operations are available for each domain (optional)

​

Configuration

The Chift MCP Server supports configuring which operations are available for each domain. By default, all operations are enabled for all domains:

DEFAULT_CONFIG = {
    "accounting": ["get", "create", "update", "add"],
    "commerce": ["get", "create", "update", "add"],
    "invoicing": ["get", "create", "update", "add"],
    "payment": ["get", "create", "update", "add"],
    "pms": ["get", "create", "update", "add"],
    "pos": ["get", "create", "update", "add"],
}

This can be customized if needed.