● Online

1CRM MCP Server

Connects AI assistants (e.g. Claude) to 1CRM via the Model Context Protocol. This is an API endpoint for MCP clients — not an interactive web UI.

For Claude Desktop: one-click extension

The easiest way for Claude Desktop — an extension that bundles everything it needs (including the Node runtime). No config-file editing, no Node/npx setup.

⬇ Download extension (.mcpb)

In Claude Desktop, install the downloaded .mcpb file under Settings → Extensions (if needed via the Advanced/Developer “Install from file” option).
Enter your 1CRM address, username and password in the form (optionally enable read-only).
Install — 1CRM shows up right away with its tools.

Your credentials stay local on your machine and only go to your 1CRM instance.

MCP endpoint

POST https://mcp.1crm.de/mcp

Authenticate with Authorization: Basic <base64(user:password)> using your own 1CRM login — or an OAuth2 Bearer token. Server status: /health.

Active guardrails

Fixed instance: https://demo.1crm.de

Available tools (10)

`list_modules`	List the available 1CRM modules.
`describe_model`	Show a module's fields, filters and links.
`list_records`	Search and filter records (field selection optional).
`get_record`	Read a record incl. related data.
`create_record`	Create a new record.
`update_record`	Update an existing record.
`delete_record`	Delete a record.
`list_related`	List a record's related records.
`link_records`	Link records together.
`unlink_records`	Remove a link again.

Set up a connection

The endpoint speaks MCP over Streamable HTTP and works with any compatible MCP client. Each user signs in with their own 1CRM login — the server stores no credentials.

Endpoint	`POST https://mcp.1crm.de/mcp`
Transport	Streamable HTTP (SSE)
`Authorization`	`Basic <base64(user:password)>` or `Bearer <token>` — required
`X-OneCRM-Base-Url`	your own 1CRM instance (optional, the server has a default)
Guardrail-Header	`X-OneCRM-Read-Only`, `X-OneCRM-Allow-Delete`, `X-OneCRM-Allowed-Modules` — optional, tightening only

Generate the Basic value: printf 'user:password' | base64.

Manual: stdio clients (e.g. Claude Desktop without the extension)

For Claude Desktop the extension above is the recommended route. Other clients that only speak stdio connect through the mcp-remote bridge. Example entry (adjust the headers accordingly):

{
  "mcpServers": {
    "1crm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.1crm.de/mcp",
        "--header",
        "Authorization:${ONECRM_AUTH}",
        "--header",
        "X-OneCRM-Base-Url: https://your-company.1crm.de"
      ],
      "env": {
        "ONECRM_AUTH": "Basic <BASE64_OF_USER:PASSWORD>"
      }
    }
  }
}