• Customermates logo
    CustomermatesDocumentation
  • Introduction
  • Comparison
Getting Started
  • Quickstart
  • Core Concepts
  • From Pipedrive
Integrations
  • Introduction
  • MCP
  • Connect Claude Desktop
  • Connect ChatGPT
  • Connect Cursor
  • Webhooks
  • OpenAPI 3.1.0
  • N8N
Self-Hosting
  • Self-Hosted vs Cloud
  • Get Started
  • Managing Your Installation
  • Architecture & Security
Reference
  • Setup AI Assistant
  • MCP Tool Catalog
  • Webhook Events
  • Filter Syntax
  • API Keys
  • Go back
  1. Introduction
  3. Connect ChatGPT

Connect ChatGPT

Use Customermates inside ChatGPT through its Connectors feature.

TL;DR — Add Customermates as a custom connector in ChatGPT, paste the URL and API key, then paste the setup prompt to start working.

Prerequisites

  • A paid ChatGPT plan that supports Connectors (Plus or higher).
  • A 64-character Customermates API key. Create one at Profile → API Keys — see API keys for details.

Configure

  1. In ChatGPT, open Settings → Connectors → Add connector.
  2. Pick Custom connector (MCP).
  3. Fill in:
    • Name: Customermates
    • URL: https://customermates.com/api/v1/mcp (self-host: swap in your URL)
    • Authentication: Header
    • Header name: x-api-key
    • Header value: your 64-character key
  4. Save. ChatGPT will ping the server and list the available tools.

First conversation

Start a new chat with the Customermates connector enabled. Paste the setup prompt as your first message. ChatGPT will orient itself and ask what to do.

Troubleshooting

SymptomCauseFix
"Connector verification failed"Wrong URL or keyRe-check URL and header value
"Tool not found"Stale connector cacheRemove the connector and re-add
ChatGPT refuses to touch relationshipsNull-wipe guard in the serverAsk ChatGPT to use link_entities / unlink_entities
Enum field rejectedValue not in the listTell ChatGPT to call get_entity_configuration first

Tips

  • ChatGPT does not remember your setup prompt across chats. Save the prompt in a snippet manager (Raycast, TextExpander, Alfred) so you can paste it fast.
  • Pin the Customermates connector so it's available on every chat that matters.
  • For long sessions, ask ChatGPT to "use search_all_entities before guessing the entity type" — the setup prompt already says this but a reminder helps on model drift.

Next

  • MCP tool catalog — every callable tool.
  • Connect Claude Desktop — if you live in Claude instead.
  • Webhooks — hear about changes outside ChatGPT.
Prerequisites
Configure
First conversation
Troubleshooting
Tips
Next