Connect an AI assistant (MCP)
Connect the ConnectSafely Agentic CRM to Claude, ChatGPT, Cursor or any MCP client, then add people, move stages, write notes and set reminders by asking.
MCP is a standard way for an AI assistant to use outside tools. ConnectSafely runs an MCP server. Once your assistant is connected to it, the assistant can read and change your CRM when you ask.
What you need
- A ConnectSafely account
- Your API key, from the API Key page
- An assistant that can connect to a remote MCP server, such as Claude, ChatGPT or Cursor
Your MCP server URL
Put your API key at the end of this address:
https://mcp.connectsafely.ai/?apiKey=YOUR_API_KEYKeep this URL private. It contains your key.
If your assistant lets you set request headers, you can leave the key out of the address and send it as a header instead:
URL: https://mcp.connectsafely.ai/
Header: Authorization: Bearer YOUR_API_KEYThe app also has an MCP Server page that shows this URL, but that page needs API access on your plan. You do not need the page. The address above with your own key is the same thing.
Connect your assistant
Follow the guide for your assistant and paste the URL when it asks for a server address.
| Assistant | Guide |
|---|---|
| Claude Desktop | Claude Desktop setup |
| Claude Code | Claude Code setup |
| ChatGPT | ChatGPT setup |
| Cursor | Cursor setup |
| VS Code | VS Code setup |
| n8n AI Agent | n8n AI Agent setup |
Check that it works
Ask your assistant:
List the stages in my ConnectSafely CRM.
It should call list-stages and answer with your stages. If the list is empty, open the CRM in the app once. Stages are created the first time a workspace opens it.
CRM tools and LinkedIn tools
The server gives your assistant two kinds of tools from the same URL.
- CRM tools need only your API key. They are listed below.
- LinkedIn tools, such as sending a message or a connection request, need a paid API plan on the LinkedIn account. Without one those calls are refused, and the CRM tools keep working.
The CRM tools
You do not need to remember these names. Ask in plain words and the assistant picks the tool.
| Tool | What it does |
|---|---|
list-prospects | Lists people, newest activity first. Can search by name or company, and filter by stage, one tag, has an email, or updated since a date. |
get-prospect | Reads one person. |
create-prospect | Adds a person by LinkedIn profile link or by email. |
update-prospect | Changes stage, owner, tags, deal value, close date, won or lost, name, company or headline. Can attach a LinkedIn profile to a person added by email. |
delete-prospect | Removes a person with their notes and reminders. |
list-prospect-notes | Reads the notes on a person, newest first. |
create-prospect-note | Writes a note, or logs a call, meeting or email. |
get-prospect-reminder | Reads the open follow-up on a person. |
set-prospect-reminder | Sets or moves the follow-up. |
delete-prospect-reminder | Marks the follow-up done. |
list-stages | Lists your pipeline stages in board order. |
list-tags | Lists the tags in use and how many people have each. |
Things to ask
Adding people:
Add https://www.linkedin.com/in/jane-doe to my CRM with the tag "webinar".
Add maria@acme.com to the CRM. Her name is Maria Lopez and she works at Acme.
Finding people:
Who is in the Replied stage?
Show me everyone tagged "warm-lead" who has an email.
Which people in my CRM were updated since Monday?
Moving deals:
Move Arjun Mehta to Meeting Booked and set the deal value to 5000.
Mark Sara Lopez as won.
Mark Arjun Mehta as lost. Reason: went with a competitor.
Notes and follow-ups:
Add a call note to Priya Shah: she wants pricing for 10 seats.
Remind me to follow up with Priya Shah next Tuesday at 10am.
I followed up with Priya Shah. Mark her reminder done.
Several steps in one message:
Go through everyone in Replied. For each person, read their notes and tell me in one line where things stand. If someone has no reminder, set one for tomorrow at 9am.
Good to know
- More than one workspace. If your key belongs to several workspaces, the list tools need to know which one. Tell the assistant the workspace, or it will get the error "workspaceId is required when your key belongs to more than one workspace".
- A stage the assistant sets stays put. Moving someone through
update-prospectcounts as a manual move, so the CRM stops moving that person's stage on its own. You can hand it back from the person's page in the app with Update it automatically. - Adding someone twice is safe. If the person is already in the CRM, the existing record comes back and nothing is duplicated. In that case the stage, tags, deal value and note you asked for are not applied. Ask the assistant to update the person instead.
- LinkedIn links must be personal profiles, like
linkedin.com/in/name. - Reminders must be in the future. Each person has one open follow-up, so setting a new one replaces the old one. The email goes to the owner of the API key, and to the person's owner if that is someone else.
- Deleting is permanent over MCP. The undo you get in the app does not exist here. Ask the assistant to confirm before it deletes anyone.
- Filters are limited to the ones listed. To filter by owner, by won or lost, or by several tags at once, use the API or the app.
Prefer a terminal?
The same twelve actions exist as CLI commands with the same names.
Using the CRM
A screen-by-screen guide to the ConnectSafely Agentic CRM. How people get added, how stages move, and how notes, reminders, tags, owners and deals work.
CRM from the CLI
Use the ConnectSafely CLI to add, find and update people in your Agentic CRM from a terminal, a script or a coding agent.
