Salesbot MCP Server – Dokumentace

Salesbot LinkedIn MCP server implementuje Model Context Protocol (Streamable HTTP) a umožňuje AI agentům (Claude, ChatGPT, Cursor) ovládat váš Salesbot účet — hledat leady, plnit kampaně, generovat a schvalovat zprávy.

1. Endpoint

POST https://app.salesbot.cz/api/mcp

• Protocol: MCP 2024-11-05 (Streamable HTTP, JSON-RPC 2.0)
• Method: POST
• Content-Type: application/json
• Accept: application/json, text/event-stream (povinné)

2. Autentizace

Každý request musí obsahovat hlavičku x-mcp-api-key s vaším MCP API klíčem (formát sb_mcp_…). Klíč vygenerujete v aplikaci Salesbot pod Nastavení → API → MCP.

x-mcp-api-key: sb_mcp_<YOUR_API_KEY>

3. Konfigurace klienta

Vložte následující JSON do konfigurace svého MCP klienta (Claude Desktop, Cursor, ChatGPT Developer Mode atd.):

{
  "mcpServers": {
    "linkedin-automation": {
      "url": "https://app.salesbot.cz/api/mcp",
      "headers": {
        "x-mcp-api-key": "sb_mcp_<YOUR_API_KEY>",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

4. Inicializace (raw HTTP)

curl -X POST https://app.salesbot.cz/api/mcp \
  -H "x-mcp-api-key: sb_mcp_<YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "my-client", "version": "1.0.0" }
    }
  }'

5. Seznam nástrojů (tools/list)

curl -X POST https://app.salesbot.cz/api/mcp \
  -H "x-mcp-api-key: sb_mcp_<YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }'

6. Dostupné nástroje

7. Limity & bezpečnost

• MCP server respektuje denní limity, povolené hodiny, blacklist domén/firem a stop-on-reply pravidla nastavená ve vašem účtu.
• Connection requesty se odesílají vždy bez zprávy (anti-block politika).
• Před odesláním zpráv se používá nastavené zpoždění v rámci provozní kadence.
• Human-in-the-loop schválení blokuje odeslání zprávy nebo pozvánky, dokud akci nepotvrdíte v aplikaci.
• Konzervativní výchozí nastavení pro MCP je 10 akcí za hodinu a 5 zpráv za hodinu na účet; první pilot držte pod 100 akcemi denně a přibližně 30–50 zprávami denně.
• Při LINKEDIN_SEARCH_PROTECTED, quota_protection nebo retry_after_seconds se nesmí požadavek ihned opakovat ani obcházet přes jiný LinkedIn search nástroj.

8. Doporučený prompt pro AI agenta

Tento prompt vložte do systémových instrukcí agenta, Cursor Skill nebo souboru AGENTS.md. Upravte jej podle vlastního schvalovacího workflow, ale neodstraňujte bezpečnostní kroky.

Jsi Salesbot Campaign Operator. Chraň LinkedIn účet. Před vyhledáváním nebo outboundem zavolej get_linkedin_status a get_daily_limits. Pokud nástroj vrátí LINKEDIN_SEARCH_PROTECTED, quota_protection nebo retry_after_seconds, neopakuj požadavek ihned a cooldown neobcházej jiným LinkedIn vyhledáváním. Použij search_google_xray, cache spojení, nebo skonči do uvedeného času.

Workflow: list_campaigns a list_lead_lists → ověř kontakty a případně upsert_linkedin_contact → add_contacts_to_campaign → list_campaign_queue → prepare_campaign_messages → list_pending_approvals → každý draft zkontroluj a approve_message nebo reject_message s feedbackem → start_campaign až po potvrzení kontaktů a zpráv. Nikdy nevypínej human-in-the-loop kvůli rychlosti. Při nejasném stavu nejdřív čti stav a neopakuj write akci. Používej přesná ID profile_id, list_id, campaign_id, contact_id, campaign_contact_id a step_id vrácená Salesbotem.

9. Další zdroje

• /llms.txt – přehled pro LLM crawlery
• /mcp-server – marketingová stránka MCP serveru
• modelcontextprotocol.io – oficiální specifikace MCP
• app.salesbot.cz – přihlášení a generování API klíče