# Kareet connectors — Claude MCP · ChatGPT OpenAPI · Grok

Agents **do not** paste Claude/ChatGPT/Grok **model** API keys.  
They connect **Kareet** (workspace auth). Tools then update Goals / listings / leads.

| Assistant | What to use | File |
|-----------|-------------|------|
| **Claude / Cowork** | Native MCP | `claude-mcp.json` or Settings → MCP & APIs in CRM |
| **ChatGPT** | Custom GPT **Actions** + OpenAPI | `chatgpt-openapi.yaml` |
| **Grok / xAI** | OpenAPI / custom tools | `grok-connector.md` + same OpenAPI |

## 1. Create a Kareet API key (once per agent or workspace)

1. Sign in at https://crm.kareet.com  
2. **Settings → APIs & Webhooks** (or **MCP & APIs**)  
3. **Create API key** → copy token  
4. Store as env `KAREET_API_KEY` (never in chat)

## 2. Claude MCP

Twenty/Kareet already exposes MCP:

```
POST https://crm.kareet.com/mcp
Authorization: Bearer <KAREET_API_KEY>
```

### Claude Desktop / Cowork config

Merge `claude-mcp.json` into Claude MCP settings, replace `${KAREET_API_KEY}` with the real key  
(or use `mcp-remote` stdio wrapper in `claude-mcp-stdio.example.json`).

In Claude:

> Use Kareet tools to score my goal and suggest next step.

After **kareet-uae-crm** is installed, logic-function tools (score-goal, create-lead, …) appear alongside core CRM tools.

## 3. ChatGPT OpenAPI Actions

1. ChatGPT → create **Custom GPT** → **Actions** → **Import from OpenAPI**  
2. Upload `chatgpt-openapi.yaml`  
3. Authentication → **API Key** → Header `Authorization` → Bearer token = Kareet API key  
   (or OAuth 2.0 when Kareet Connect is wired)  
4. Save and test: “Create a lead named Ahmed, intent BUY, budget 3M AED Marina”

## 4. Grok connector

See `grok-connector.md`. Import the **same** OpenAPI file; auth is Kareet bearer token.

## 5. Human path (no connector)

In CRM after UAE app install:

- **Goals** → Score goal / Suggest next  
- **Listings** → Score ladder  
- **Leads** → Match / Suggest next  

Same business rules as the OpenAPI/MCP tools.

## Product rule

| Never | Always |
|-------|--------|
| Agent pastes `sk-ant-…` / OpenAI platform key into Kareet | Agent pastes **Kareet** API key into Claude/ChatGPT/Grok (or clicks Connect) |
| AI-only actions humans can’t re-run | Command menu mirrors every tool |

## Install UAE app (ops)

```bash
cd packages/twenty-apps/public/kareet-uae-crm
# needs Node 24 + yarn
yarn
yarn twenty remote:add --url https://crm.kareet.com --as prod --api-key "$KAREET_API_KEY"
yarn twenty dev --remote prod
# or: yarn twenty app install --remote prod  (after build/publish)
```

Until the app is installed, MCP still works for **core Twenty objects**; Goal/listing HTTP tools need the UAE app.