Guide · Connect AI (MCP)

MCP server: let Claude or ChatGPT set up and run your CRM

Connect an AI with one click. It sets up channels, the phone system, contacts and deals, reads your inbox and writes reply drafts – only with the permissions you choose.

Free for up to 3 users, no credit card. The MCP server is included in every plan.

Updated 13 Nov 2026 · The-Y CRM 1.1.66 · about 8 minutes to read

In short

The-Y CRM has an MCP server since version 1.1.66. MCP (Model Context Protocol) is a public standard that lets AI programs such as Claude or ChatGPT use tools in other software. Once connected, the AI can set up your channels, the phone system with extensions, ring groups and phone hours, contacts, deals, tasks and reply templates, and it can read your inbox. By default it only reads and writes drafts; sending and connecting channels need their own permissions. It can't delete anything, make calls or see passwords. Included in every plan: Free, and Cloud Pro at €20/month per company, all users and brands (alpha and beta price).

As of November 2026

How it works with The-Y CRM

Sign up for free, open Settings → Integrations → “Connect AI (MCP)” and connect Claude or ChatGPT. You sign in to The-Y CRM, choose what the AI may do and click “Allow”. Everything the AI does shows up in your account's log.

Connecting an AI needs your own account; the demo shows the CRM with sample data. The-Y CRM is in Alpha. All features and prices: The-Y CRM

Instead of clicking through settings, you tell the AI what you need, for example: “Show me what is still missing in my CRM.” Or: “Create extensions 101 to 104 for Anna, Ben, Carla and David, put them in one ring group and send calls outside 9 to 5 to voicemail.” The AI does it through the MCP server, and you see the result in the app and in the log.

Below: what MCP is, what the AI can and can't do, how to connect Claude, Claude Code and ChatGPT step by step, and how the permissions and limits work.

What is an MCP server?

MCP stands for Model Context Protocol, a public standard for connecting AI programs to other software. It's published at modelcontextprotocol.io; the current version of the specification is dated 28 July 2026. An MCP server is the part of a piece of software that offers the AI a list of tools, such as “Create extension” or “Read conversation”, and checks every call.

The-Y CRM's MCP server runs at one address for all accounts:

https://crm.the-y.at/api/mcp

If you run The-Y CRM on your own server, it's your address followed by /api/mcp; there is nothing extra to set up. The server follows the current specification and also works with AI programs that still use older versions (from 2025-03-26). Transport: “Streamable HTTP”.

What the AI can do: 23 tools

Each tool needs a permission. There are three levels, and you pick one when you connect: Read and write drafts (recommended), Set up, and the separate tick box May send messages to customers. The AI only sees the tools its connection may use.

Overview

ToolWhat the AI doesPermission
Account overviewget_account_overviewShows your channels and their state, the phone line, what is still missing (with a link into the app) and what this connection may do. The usual first step.Read and write drafts

Channels: email and web chat

ToolWhat the AI doesPermission
Set up mailboxsetup_mailboxCreates an email mailbox and enters the servers (IMAP/SMTP); Gmail servers are filled in automatically. No password: you enter it yourself via a link, and for Microsoft you click “Sign in with Microsoft”.Set up (connect channels)
Web chat: embed codeget_webchat_embed_codeReturns the code for your website and the link to the chat page.Read and write drafts
Switch web chat on/offset_webchat_enabledSwitches the web chat on or off and returns the embed code.Set up (connect channels)

Phone system

ToolWhat the AI doesPermission
Phone overviewget_phone_setupShows extensions, ring groups, phone hours, numbers with their destination, lines (without passwords), queues, menus and announcements.Read and write drafts
Create extensioncreate_extension2 to 6 digits, optionally for a team member and with voicemail. The password for the desk phone or app is generated automatically and only shown in the app.Set up
Create ring groupcreate_ring_groupSeveral extensions ring at once.Set up
Ring group: set membersset_ring_group_membersSets which existing extensions belong to a ring group.Set up
Set phone hoursset_phone_hoursWhen the phone is “open”, and where calls go during and outside those times, for example ring group by day, voicemail at night.Set up
Add phone numberadd_phone_numberAdds a number from your phone provider, with country code.Set up
Phone number: set destinationset_number_destinationExtension, ring group, queue, voicemail, menu, announcement, phone hours or hang up. Forwarding to outside numbers only in the app.Set up
Create phone linecreate_phone_lineCreates the line (SIP) to your phone provider, without password. It only becomes active once you enter the password in the app.Set up (connect channels)

Contacts, deals and tasks

ToolWhat the AI doesPermission
Search contactssearch_contactsBy name, email or phone number.Read and write drafts
Create/import contactsimport_contacts1 to 500 at once; same email address = the existing contact is completed; preview first if you like. The AI never sets marketing consent.Set up
View pipelineslist_pipelinesLists your pipelines and their stages.Read and write drafts
Create dealcreate_dealTitle, value, stage, contact, company, expected close.Set up
Create taskcreate_taskWith due date, assignee and a link to a contact, company, deal or conversation.Set up

Inbox and reply templates

ToolWhat the AI doesPermission
View inboxlist_conversationsLists conversations, newest first, filtered by status or channel if you like.Read and write drafts
Read conversationget_conversationReads a conversation with its latest messages; internal notes are marked.Read and write drafts
Create reply draftcreate_reply_draftSaves a reply as an internal note headed “NOT sent yet”. It never reaches the customer; someone in your team checks it and sends it.Read and write drafts
View reply templateslist_reply_templatesLists your text snippets for replies.Read and write drafts
Create reply templatecreate_reply_templateTitle, text, optional shortcut, language and brand.Set up
Send replysend_replySends a reply over the conversation's channel, with the same rules as “Send” in the inbox: 24-hour window, consent, the Free plan's monthly limit.May send messages to customers (separate tick box)

What the AI can't do

How to connect your AI program

There are two ways, with the same checks behind them:

Only people who may manage integrations in your account, for example admins, can connect an AI program.

Claude (claude.ai and Claude Desktop)

  1. In Claude, go to Customize → Connectors, click “+ Add” and then “Add custom connector”.
  2. Enter the name The-Y CRM and the remote MCP server URL https://crm.the-y.at/api/mcp. Click “Continue”, check the sign-in settings Claude detected and click “Continue” again.
  3. Authentication: “Sign in now”. OAuth client: “Use Claude's published identity (Recommended)”. Then click “Add”.
  4. Our sign-in page opens: sign in to The-Y CRM, choose what the AI may do, click “Allow”.
  5. In a chat, click “+” at the bottom left, open “Connectors”, switch The-Y CRM on and write, for example: “Show me what is still missing in my CRM.”

On Claude Team and Enterprise, the people who manage your Claude organisation add the connector first (Organization settings → Connectors → “Add” → “Custom” → “Web”). After that, everyone connects it under Customize → Connectors with their own sign-in. According to Anthropic, custom connectors work on the Free, Pro, Max, Ultra, Team and Enterprise plans; on Free you can add one.

Claude Code

Enter once in the terminal:

claude mcp add --transport http the-y-crm https://crm.the-y.at/api/mcp

Then type /mcp in Claude Code, choose “the-y-crm” and sign in; the browser opens our sign-in page. It points out that the program runs on your computer (localhost), which is expected for Claude Code. Or with an API key:

claude mcp add --transport http the-y-crm https://crm.the-y.at/api/mcp --header "Authorization: Bearer <your key>"

ChatGPT

  1. In ChatGPT on the web, open Plugins, click “+” and then “Add custom MCP server”.
  2. Name: The-Y CRM. Under Connection enter https://crm.the-y.at/api/mcp. Authentication: OAuth.
  3. Tick “I understand and want to continue” and click “Create as a plugin”.
  4. Our sign-in page opens: sign in to The-Y CRM, choose what the AI may do, click “Allow”. ChatGPT then shows the tools it found.
  5. Start a new chat, type @ and choose The-Y CRM.

Who can do this is up to OpenAI: according to OpenAI, custom MCP servers with full access are available in ChatGPT Business, Enterprise and Edu, on the web only. In Business workspaces only admins can add them; Enterprise and Edu admins can allow it for selected members. According to OpenAI, other plans are limited. Before actions that change something, ChatGPT may ask you to confirm.

Other programs and API keys

More on keys and the REST API: API documentation.

Permissions: you decide

Security and limits

Limits per key or connection, on top of your plan's API limits:

Kind of toolPer minutePer hour
Read601,200
Change30600
Connect a channel1030
Send1060

Plan limits per account (shared with the REST API): Free 60 requests a minute and 1,000 a day, Cloud Pro 300 a minute; self-hosted none unless you set them.

More on how we protect your data: Security.

Prices

The MCP server costs nothing extra. It's part of every plan, Free included.

Free
€0 forever
Up to 3 users, 1,000 outgoing messages and 200 outgoing call minutes a month, 2 simultaneous calls. MCP included. Messages the AI sends count toward the 1,000; drafts don't.
Cloud Pro
€20 /month per company
All users and brands (alpha and beta price), incl. any VAT; €40 from the Live release. Up to 10 simultaneous calls, hosted in Vienna. MCP included. Businesses only.

Prefer your own server? The-Y CRM also runs self-hosted with Docker, with the same MCP server: Self-hosted helpdesk · Self-hosting guide.

When it fits, and when it doesn't

A good fit if …

  • you want a new account set up quickly: mailbox, web chat, extensions, ring groups, phone hours,
  • you have a contact list to import,
  • you want reply drafts for a full inbox that your team checks before sending.

Not the right tool if …

  • your AI program can't connect custom MCP servers (for ChatGPT, see the plans above),
  • you want to connect WhatsApp, delete data or make calls through the AI,
  • you need proven, mature software today; The-Y CRM is Alpha.
Honestly
  • The-Y CRM is Alpha software, and the MCP server is new in 1.1.66. AI programs make mistakes too: check what the AI set up, every step is in the log.
  • Not included in 1.1.66: the account's opening hours, inviting team members, brands, email templates and submitting WhatsApp templates. You do these in the app.
  • If an AI program renews its sign-in twice at the same moment, we disconnect it for safety. Then simply connect again.
  • Open points: Known issues.

Sources: Model Context Protocol, specification version 2026-07-28, checked 12 Nov 2026 · Claude: Anthropic Help Center “Get started with custom connectors using remote MCP” (plans, menu steps), checked 12 Nov 2026 · Claude Code: Claude Code docs “MCP”, checked 12 Nov 2026 · ChatGPT: OpenAI Help Center “Connecting custom MCP servers in ChatGPT” (plans, menu steps), checked 12 Nov 2026. Menu names and plans of AI programs change, so please check with the provider. Claude is a trademark of Anthropic, ChatGPT of OpenAI.

Frequently asked questions

Can ChatGPT send messages on its own?

Only if you allow it. When you connect, “May send messages to customers” is a separate tick box and never preselected. Without it, ChatGPT saves replies as drafts: an internal note in the conversation that your team checks and sends. With it, the same rules apply as in the inbox (24-hour window, consent, the Free plan's monthly limit), with at most 10 messages a minute and 60 an hour per connection. According to OpenAI, ChatGPT may also ask you to confirm before it changes something; full support is available for Business, Enterprise and Edu, other plans are limited (as of 12 Nov 2026).

Where is my data?

Your CRM data stays on our server in Vienna, Austria, inside the EU, or on your own server if you self-host. What the AI reads through the MCP server, for example contacts or conversations depending on the permissions you choose, goes to the provider of your AI program, such as Anthropic or OpenAI, under that provider's terms. Our log records which tool ran and when, with IDs only: no message text, no names, addresses or phone numbers. A data processing agreement is available.

Do I need an AI subscription?

Not from us: the MCP server costs nothing extra in The-Y CRM. You need an AI program that can connect MCP servers, and its provider sets the rules. Claude offers custom connectors on Free, Pro, Max, Ultra, Team and Enterprise; on Free you can add one. ChatGPT offers custom MCP servers with full access in Business, Enterprise and Edu on the web, other plans are limited. As of 12 Nov 2026, according to Anthropic's and OpenAI's help pages.

Is the MCP server included in the Free plan?

Yes. It's part of every plan: Free, Cloud Pro and self-hosting. On Free, requests count toward the account's API limit of 60 a minute and 1,000 a day; Cloud Pro allows 300 a minute. Messages the AI sends count toward Free's 1,000 outgoing messages a month; drafts don't.

What can't the AI do?

It can't delete anything, make phone calls, forward calls to outside numbers, connect WhatsApp (that needs your own sign-in with Meta) or set marketing consent. It never gets passwords: for a mailbox or phone line it sends you a link, and you enter the password in the app yourself.

How do I disconnect the AI?

Under Settings → Integrations → “Connected AI programs”, click “Disconnect”; access ends immediately. Keys can be revoked in the “API keys” list. A connection by click is valid for 90 days, after which you connect again.

Does it work if I host The-Y CRM myself?

Yes, it's the same software: your address followed by /api/mcp, with nothing extra to set up. For Claude and ChatGPT your server must be reachable from the internet over HTTPS.

Try it yourself

Sign up for free, then connect Claude or ChatGPT under Settings → Integrations → “Connect AI (MCP)”. You can also sign up with your Google account, no password needed. The demo shows the CRM with English sample data, no sign-up needed.

Questions? sales@the-y.at