# Solk MCP

> Connect AI assistants like Claude to your CRM — ask about companies and opportunities, and create tasks and activity logs right from the chat.

Solk MCP is a **Model Context Protocol** server that runs in every installation. When an AI assistant that supports MCP (Claude, Claude Code, ChatGPT developer mode, Cursor, VS Code…) connects to this server, it can query your CRM in natural language and create records with your approval.

```text
https://<company>.solk.app/mcp
```

The **Settings → App connections** (*Ayarlar → Uygulama bağlantıları*) page in the CRM shows your connector URL and copies it with one click.

## What you can do

:::cards
- [Find companies and people](/mcp/prompts#lookup) search | "Who handles purchasing at Alize Paketleme, and what did we last talk about?"
- [Daily to-do list](/mcp/prompts#today) check | "What are my overdue actions for today and this week?"
- [Pipeline](/mcp/prompts#pipeline) target | "Sort the opportunities in Negotiation by value and flag the ones past their SLA."
- [Create records](/mcp/prompts#write) plus | "Log the phone call I just had with Kuzey Plastik and create a quote action for Thursday."
:::

## Get started

**Requirements:** A user account in your Solk installation and a client that supports MCP. The connection runs under your account; no additional license is required.

### Claude (claude.ai, desktop, and mobile)

1. In Claude, open **Customize → Connectors → + Add → Add custom connector**.
2. Enter `Solk` as the name, paste `https://<company>.solk.app/mcp` as the URL, and click **Add**.
3. Click **Connect**. The Solk sign-in page opens (or the consent screen directly, if you're already signed in); approve the permissions.

On Team and Enterprise plans, the organization owner adds the custom connector once (**Organization settings → Connectors → Add → Custom → Web**); each member then clicks **Connect** with their own Solk account. On the Free plan, you can add one custom connector.

### Claude Code

```bash
claude mcp add --transport http solk https://ornek.solk.app/mcp
```

In Claude Code, type `/mcp`, select the **solk** server, and grant access on the consent screen that opens in your browser.

### Other clients

Enter the URL in your client as a remote MCP server (Streamable HTTP); the client handles OAuth discovery itself. For tools that don't support OAuth and require a static header, an admin can use an API key created in **Settings → Developers** (*Ayarlar → Geliştiriciler*):

```json
{
  "mcpServers": {
    "solk": {
      "url": "https://ornek.solk.app/mcp",
      "headers": { "Authorization": "Bearer sk_…" }
    }
  }
}
```

Detailed steps: [Connect](/mcp/connect).

## Tools

The server provides 14 read tools and 9 write tools: search; reading companies, people, opportunities, actions, calendar, and email; dashboards and "Today"; creating companies, people, opportunities, tasks, and notes; changing stages; completing actions; and logging activities. Full list and parameters: [Tools](/mcp/tools).

## Security

- **OAuth-based authentication** — your password is never given to the client; you see the requested permissions on the consent screen.
- **Your account's permissions** — the assistant sees only the records you can see and changes only the records you can change; your role, module permissions, and record visibility all apply as is.
- **Separate read and write** — the `crm.read` and `crm.write` scopes are approved separately; read tools are reported to the client as "read-only".
- **Revocable** — in **Settings → App connections** (*Ayarlar → Uygulama bağlantıları*), you see connected apps, their last use, and their operation count, and you can cut off access instantly with **Remove access** (*Erişimi kaldır*).
- **Auditable** — every tool call is recorded in the audit log.

Details: [Security](/mcp/security).

## Limits

300 requests per minute per token. A tool response carries at most ~90,000 characters; longer responses are truncated, with a note at the end saying that paging or a filter is needed.