> ## Documentation Index
> Fetch the complete documentation index at: https://developers.qomon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server 

> Connect Claude or ChatGPT to your Qomon space and query live data in real time.

## Overview

The Qomon MCP server lets you connect your Qomon space directly to AI assistants like Claude and ChatGPT.

Unlike documentation files, MCP gives your assistant **live access** to your data — contacts, actions, users, fundraising — without copy-pasting anything.

## Choose this when

* You want an assistant to read live data from a specific Qomon space.
* You need answers based on current records, not just public docs.
* You are already past the point where documentation context alone is enough.

<Note>
  The MCP server authenticates via an API key tied to a specific Qomon space. Each space requires its own key and its own connector.
</Note>

***

## Create a Qomon account

Before connecting Qomon to your AI assistant, you need a Qomon account and access to a workspace. If you don't have one yet, here's how to get started in 2 minutes.

1. Go to [**qomon.com**](http://qomon.com)
2. Click **Login** — then **Create a new account** if you don't have one yet
3. Once logged in, select or create the **workspace** you want to connect

***

## Prerequisites

Before connecting, generate an API key for the Qomon space you want to query:

1. Go to your Qomon space → **Settings → Integrations & API**
2. Under **Generate API Keys**, click **+ Add**
3. Name your key (e.g. `mcp-claude`) and copy it — you'll need it during setup

***

## Connect to Claude

<Info>
  Available on the **Team plan**. Once added at the organization level, all team members have access automatically — no individual setup required.
</Info>

<Steps>
  <Step title="Open Claude settings">
    Go to [claude.ai](https://claude.ai) → **Settings** → **Connectors**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/eva0FyaS1QYcDQkf/images/For-Jason-(5).png?fit=max&auto=format&n=eva0FyaS1QYcDQkf&q=85&s=9367b0772b31714bab884d37899ae0f7" alt="For Jason (5)" width="5280" height="2970" data-path="images/For-Jason-(5).png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(15).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=d5cc167102d2058e15d96a5e7577e354" alt="For Jason (15)" width="5280" height="2970" data-path="images/For-Jason-(15).png" />
    </Frame>
  </Step>

  <Step title="Enter the MCP server URL">
    In the Name field, enter `qomon-mcp`. In the "Remote MCP server URL" field, paste `https://mcp.qomon.ai/mcp` and click **Add**.

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(17).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=85bb568679d85fe7d0ceb3941d119a0d" alt="For Jason (17)" width="4320" height="2430" data-path="images/For-Jason-(17).png" />
    </Frame>
  </Step>

  <Step title="Find the Qomon connector">
    Scroll to find **qomon-mcp** and click **Connect**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(16).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=2e371ae011d9c336c546726a1fe1b437" alt="For Jason (16)" width="5280" height="2970" data-path="images/For-Jason-(16).png" />
    </Frame>
  </Step>

  <Step title="Authenticate">
    An OAuth popup opens — paste your **Qomon API key**, select your region, and click **Connect**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(10).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=4fb0bbbc5ef716fe628ede960be2784f" alt="For Jason (10)" width="5280" height="2970" data-path="images/For-Jason-(10).png" />
    </Frame>
  </Step>

  <Step title="Start a new conversation">
    Open a new chat — You're all set! Try asking Claude to search your contacts, list actions, or browse fundraising data

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(14).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=e5b5fb7e693d6625f25ab59d83297e55" alt="For Jason (14)" width="5280" height="2970" data-path="images/For-Jason-(14).png" />
    </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="CSRF validation failed">
    Browser cookie issue. Retry in a **private/incognito window**.
  </Accordion>

  <Accordion title="Connector not active after connecting">
    Always open a **new conversation** — existing chats won't pick up new connectors.
  </Accordion>

  <Accordion title="Connecting a different Qomon space">
    Each space needs its own connector and API key. Contact your Claude Team admin to add a new one.
  </Accordion>
</AccordionGroup>

***

## Connect to ChatGPT

<Info>
  In **beta**. Requires a **Plus or Pro** subscription with Developer Mode enabled.
</Info>

Go to [chatgpt.com](https://chatgpt.com) (Web version) → **Settings** → **Apps**

<Steps>
  <Step title="Create a new connector">
    In **Settings → Connectors**, click **Create**
  </Step>

  <Step title="Enable Developer Mode first">
    Go to [**chatgpt.com**](http://chatgpt.com) (web version) → **Settings** → **Apps** → **Advanced settings** → toggle **Developer mode** on, then click **Create app**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(19).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=116312cc04e36df8c20409fe7d32ff57" alt="For Jason (19)" width="4320" height="2430" data-path="images/For-Jason-(19).png" />
    </Frame>
  </Step>

  <Step title="Enter the MCP server URL">
    ```text theme={"system"}
    https://mcp.qomon.ai/mcp
    ```
  </Step>

  <Step title="Create a new connector">
    A "New App" form opens. Fill in: **Name** → `Qomon`, **Connection** → paste `https://mcp.qomon.ai/mcp`, **Authentication** → leave OAuth. Check "I understand and want to continue" and click **Create**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(20).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=5f203afe29c32922b7c790f1d1787e52" alt="For Jason (20)" width="4320" height="2430" data-path="images/For-Jason-(20).png" />
    </Frame>
  </Step>

  <Step title="Authenticate">
    A Qomon OAuth popup opens — select your **region**, paste your **Qomon API key**, and click **Connect**

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(10)-1.png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=741e9c1605690034f8a8079ae0a36227" alt="For Jason (10) 1" width="5280" height="2970" data-path="images/For-Jason-(10)-1.png" />
    </Frame>
  </Step>

  <Step title="Enable in chat">
    New chat → click **+** → **More** → **Developer Mode** → **Add sources** → enable Qomon
  </Step>

  <Step title="Qomon is now enabled">
    Your Qomon app now appears under **Enabled apps** in Settings → Apps

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(21).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=7283b6487ef7b3d4ea35975544d66b1a" alt="For Jason (21)" width="4320" height="2430" data-path="images/For-Jason-(21).png" />
    </Frame>
  </Step>

  <Step title="Start a new conversation">
    Open a new chat. You're all set! Try asking ChatGPT to search your contacts, list actions, or browse fundraising data

    <Frame>
      <img src="https://mintcdn.com/qomon-86428773/fuov2pKIh80Duxbd/images/For-Jason-(22).png?fit=max&auto=format&n=fuov2pKIh80Duxbd&q=85&s=d4946a1abf20cb4d4d9537893decda95" alt="For Jason (22)" width="4320" height="2430" data-path="images/For-Jason-(22).png" />
    </Frame>
  </Step>
</Steps>

If you only need public documentation context, use [`/llms.txt`](/llms.txt) or [`/llms-full.txt`](/llms-full.txt) instead.

***

## Connect to your own model

The Qomon MCP server follows the open **Model Context Protocol (MCP)** standard — which means it works with any MCP-compatible AI assistant or environment, not just Claude or ChatGPT. Cursor, Windsurf, Continue, or any custom LLM setup can connect to it the same way.

Use the following MCP server URL:

```text theme={"system"}
https://mcp.qomon.ai/mcp
```

If you want to give your model context about the Qomon API (endpoints, structure, guides) rather than live workspace data, check out the [LLM-Ready Documentation](https://developers.qomon.com/pages/v1/build-with-llms) instead.

***

## Best use cases

Once Qomon is connected to your AI assistant, here are the prompts that work best.

<Warning>
  On ChatGPT Plus/Pro, MCP connectors are **read-only**. Write operations require a Business or Enterprise plan.
</Warning>

| Profile / Use case   | What you can do                                                   | Example prompt                                                                            |
| :------------------- | :---------------------------------------------------------------- | :---------------------------------------------------------------------------------------- |
| **Field organizer**  | Search and segment contacts by tag, location, or support level    | *"Find all contacts tagged 'volunteer' in London with an email address"*                  |
| **Campaign manager** | Analyze your actions — participation, status, history             | *"List my last 10 canvassing actions and their participation rates"*                      |
| **Fundraising team** | Browse donations and transactions in real time                    | *"Show me all donations above \$500 from the last 30 days"*                               |
| **Operations**       | Query your team members and org structure                         | *"Who are the active users in my organization?"*                                          |
| **Data entry**       | Create or update contacts directly from a conversation            | *"Create a new contact: Jane Smith, [jane@example.com](mailto:jane@example.com), London"* |
| **Reporting**        | Cross-reference contacts, actions and donations for a quick brief | *"How many contacts attended an action in Birmingham this year?"*                         |
