Collabim MCP Server

Přístup k Collabim datům přes Model Context Protocol v Cursoru, Claude a dalších nástrojích.

Rychlý start

Tento server používá OAuth client_credentials. Collabim API klíč zůstává uložený na straně MCP serveru.

Přidejte MCP server v Cursoru: Settings → Tools & MCP → New MCP Server

Zkopírujte OAuth údaje z Collabimu – najdete je v nastavení účtu u API klíče jako MCP client ID a MCP client secret. MCP klient je použije pro OAuth client_credentials flow.

Pokud váš MCP klient zatím neumí OAuth client_credentials automaticky, vyžádejte access token přes POST https://mcp.oncollabim.com/oauth/token a vložte ho do konfigurace:

{
  "mcpServers": {
    "collabim-api": {
      "url": "https://mcp.oncollabim.com",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Nainstalujte si Node.JS zde.

Přidejte MCP server v Claude: Settings → Developer → Edit Config → claude_desktop_config.json (Otevřít v text editoru)

Zkopírujte OAuth údaje z Collabimu – najdete je v nastavení účtu u API klíče jako MCP client ID a MCP client secret. MCP klient je použije pro OAuth client_credentials flow.

Pokud váš MCP klient zatím neumí OAuth client_credentials automaticky, vyžádejte access token přes POST https://mcp.oncollabim.com/oauth/token a vložte ho do konfigurace:

{
  "mcpServers": {
    "collabim-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.oncollabim.com",
        "--header",
        "Authorization: Bearer YOUR_ACCESS_TOKEN"
      ]
    }
  }
}

Uložte a restartujte Claude.

Bez platného access tokenu server vrátí 401 a nebudete mít přístup k datům.

Videonávod

Dostupné nástroje (tools)

V Cursoru / Claude můžete volat tyto příkazy – AI je použije podle kontextu. Všechna data jsou navázaná na váš API klíč.

Projekty

collabim_projects_list

Seznam projektů. Volitelné filtry: nameLike, active, page, itemsPerPage.

collabim_project_get

Jeden projekt podle ID.

collabim_project_widget / collabim_project_widget_json

Widget projektu (HTML nebo JSON), typ např. fullWidget.

Aktivity

collabim_activities_list

Seznam aktivit. Filtry: projectId, typeId, stateId, categoryId, addedOnFrom/To, urlLike, webId, stránkování.

collabim_activity_get

Jedna aktivita podle ID.

collabim_activity_create

Vytvořit aktivitu/odkaz. Povinné: projectId, typeId, stateId a webId nebo webSiteUrl.

collabim_activity_update

Upravit aktivitu (stateId, typeId, webId, note, …).

collabim_activity_delete

Smazat aktivitu podle ID.

Klíčová slova a pozice

collabim_keywords_list

Seznam klíčových slov. Filtry: projectId, keyword, keywordLike, tags, targetPageId, starred.

collabim_keyword_positions

Historie pozic. projectId + lastXDays nebo from+to; volitelně projectKeywordIds, tags.

collabim_aggregated_keyword_positions

Agregované pozice klíčových slov.

collabim_position_distribution

Rozdělení pozic (Top 3, 4–10, 11–20, 21+). projectId + lastXDays nebo from+to.

collabim_market_dominator

Hodnoty market dominator.

collabim_indexed_pages

Indexované stránky projektu.

collabim_market_share

Market share. Vyžaduje projectId a searchEngineId.

Holy Grail, AI Overviews, další

collabim_holy_grail_stats / collabim_holy_grail_aio_stats / collabim_holy_grail_aio_data

Souhrnné statistiky Holy Grail a AIO data pro doménu (bez placeného organického exportu níže).

collabim_holy_grail_organic_data

Placený export organických dat Holy Grail (klíčová slova) pro sledovanou doménu — odpovídá API GET /holy-grail-api-data/{domain}. Nástroj vždy posílá charge=1: u první stránky (offset 0) se založí jednorázová analýza (OTA), strhnou se kredity (pokud existují data) a spustí se export. Odpověď obsahuje řádky a meta (limit, offset, total, otaId, has_more, next_url). Stránkování: volitelně limit (max 5000), offset; u offset > 0 je povinný otaId z první odpovědi — další stránky se znovu neúčtují. Volitelně format: json nebo csv.

collabim_google_ai_overviews

Google AI Overviews pro doménu. Volitelně projectId, format.

collabim_google_ai_overviews_competitors

Google AI Competitors pro doménu. Vyžaduje projectId a searchEngineId. Volitelně format.

collabim_google_ai_overviews_market_share

Google AI Market Share pro doménu. Vyžaduje projectId a searchEngineId. Volitelně from, to, lastXDays, getXDays, tagName, format.

collabim_category_heureka_tree

Stáhnout kategorie Heureka jako XLSX.

collabim_website_system

Detekce systému webu podle URL.

collabim_user_key

Získat API klíč uživatele přihlášením (pro affil partnery).

collabim_accounts_new

Vytvoření nového Collabim účtu (affil).

collabim_ota_keyword_measuring / collabim_ota_keyword_measuring_status

OTA měření klíčových slov (batch) a stav/výsledky.

Jednorázové analýzy

collabim_content_suggestions_start

Spustí AI Content Suggestions pro zadanou URL nebo doménu, vrátí otaId.

collabim_content_suggestions_status

Vrací výsledek podle otaId.

collabim_llm_analysis_start

Spustí Analýzu jazykových modelů pro zadaný web, vrátí otaId.

collabim_llm_analysis_status

Vrací výsledek podle otaId.

collabim_suggest_search_volume_start

Spustí analýzu Návrhy klíčových slov pro zadaná klíčová slova, vrátí otaId.

collabim_suggest_search_volume_status

Vrací výsledek podle otaId.

collabim_suggest_search_volume_info

Vrátí dostupné volby suggesters a keywordTools pro vybranou zemi (countryCode).

collabim_position_search_volume_start

Spustí jednorázovou analýzu pozice, hledanosti a allInTitle (KGR) pro zadaná klíčová slova, vrátí otaId.

collabim_position_search_volume_status

Vrací výsledek podle otaId.

collabim_google_ai_mode_analysis_start

Spustí Google AI Mode analýzu pro zadaná klíčová slova, searchEngineId a URL/doménu, vrátí otaId.

collabim_google_ai_mode_analysis_status

Vrací výsledek podle otaId.

collabim_url_analysis_start

Spustí URL analýzu pro zadanou URL (např. Indexace URL a Analýzu webu), vrátí otaId.

collabim_url_analysis_status

Vrací výsledek podle otaId.

collabim_google_ai_analysis_start

Spustí Google AI Overviews analýzu pro zadaná klíčová slova a searchEngineId, vrátí otaId.

collabim_google_ai_analysis_status

Vrací výsledek podle otaId.

collabim_ppc_analysis_start

Spustí PPC analýzu pro zadaná klíčová slova a zvolené typy analýz, vrátí otaId.

collabim_ppc_analysis_status

Vrací výsledek podle otaId.

Prompty

collabim_project_prompts_list

Seznam promptů v projektu. Vyžaduje projectId. Volitelné filtry: tag, llmType (chatgpt|gemini|perplexity), projectUrl, text, id, positionMeasurementInterval, page, resultsPerPage.

collabim_project_prompts_overview

Přehled metrik promptů v projektu. Vyžaduje projectId. Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365) a tag.

collabim_project_prompts_sources

Nejcitovanější domény a citation gaps v LLM odpovědích. Vyžaduje projectId. Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365; default 7), llmType (chatgpt|gemini|perplexity), tag.

collabim_project_prompts_citations

Seznam jednotlivých citací (prompt → URL/doména). Vyžaduje projectId. Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365; default 7), llmType (chatgpt|gemini|perplexity), tag, domain. Paginace: page, resultsPerPage/results (max 50).

collabim_project_prompts_fan_out

Fan-out dotazy prozkoumávané LLM u promptů. Vyžaduje projectId. Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365; default 7), llmType (chatgpt|gemini|perplexity), tag. Paginace: page, resultsPerPage/results (max 100).

collabim_project_prompts_competitors_visibility

Vaše viditelnost vs. konkurenti u promptů. Vyžaduje projectId (projekt musí mít nastavené konkurenty). Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365; default 7), tag. Paginace: page, resultsPerPage/results (max 100).

collabim_project_prompts_competitors_share_of_voice

Váš share of voice vs. konkurenti u promptů. Vyžaduje projectId (projekt musí mít nastavené konkurenty). Volitelné filtry: days (7, 14, 30, 60, 90, 180, 360, 365; default 7), tag. Paginace: page, resultsPerPage/results (max 100).

collabim_project_prompts_add

Přidá prompty do projektu. Vyžaduje projectId a prompts (string[]). Volitelné: llmTypes, tags, measurementInterval.

collabim_project_prompts_delete

Smaže prompty podle promptIds. Vyžaduje projectId a promptIds. Bez dryRun — nejdřív ověř seznam promptů.

collabim_project_prompts_tags

Nahradí tagy u promptů. Vyžaduje projectId, promptIds a tags (prázdné pole smaže všechny tagy).

collabim_project_prompts_remeasure

Znovu změří prompty (premium). Vyžaduje projectId a promptIds. Spotřebuje LLM sloty.

collabim_prompt_details_get

Vrátí detailní informace o konkrétním AI promptu v rámci daného projektu.

collabim_prompt_details_patch

Tento endpoint slouží k částečné aktualizaci (patch) textu, intervalu měření nebo štítků u konkrétního promptu v rámci vybraného projektu podle jejich ID.

Collabim MCP Server

Access your Collabim data via Model Context Protocol in Cursor, Claude and other tools.

Quick start

This server uses OAuth client_credentials. The Collabim API key stays stored on the MCP server side.

Add MCP server in Cursor: Settings → Tools & MCP → New MCP Server

Copy OAuth credentials from Collabim – they are in account settings next to the API key as MCP client ID and MCP client secret. Your MCP client uses them for the OAuth client_credentials flow.

If your MCP client does not support OAuth client_credentials automatically yet, request an access token with POST https://mcp.oncollabim.com/oauth/token and paste it into the configuration:

{
  "mcpServers": {
    "collabim-api": {
      "url": "https://mcp.oncollabim.com",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Install Node.js here.

Add MCP server in Claude: Settings → Developer → Edit Config → claude_desktop_config.json (Open in text editor)

If your MCP client does not support OAuth client_credentials automatically yet, request an access token with POST https://mcp.oncollabim.com/oauth/token and paste it into the configuration:

{
  "mcpServers": {
    "collabim-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.oncollabim.com",
        "--header",
        "Authorization: Bearer YOUR_ACCESS_TOKEN"
      ]
    }
  }
}

Save and restart Claude.

Without a valid access token the server returns 401 and you will not have access to the data.

Video tutorial

Available tools

In Cursor / Claude you can call these commands – the AI will use them based on context. All data are tied to your API key.

Projects

collabim_projects_list

List of projects. Optional filters: nameLike, active, page, itemsPerPage.

collabim_project_get

Single project by ID.

collabim_project_widget / collabim_project_widget_json

Project widget (HTML or JSON), type e.g. fullWidget.

Activities

collabim_activities_list

List of activities. Filters: projectId, typeId, stateId, categoryId, addedOnFrom/To, urlLike, webId, pagination.

collabim_activity_get

Single activity by ID.

collabim_activity_create

Create activity/link. Required: projectId, typeId, stateId, and webId or webSiteUrl.

collabim_activity_update

Update activity (stateId, typeId, webId, note, …).

collabim_activity_delete

Delete activity by ID.

Keywords and positions

collabim_keywords_list

List of keywords. Filters: projectId, keyword, keywordLike, tags, targetPageId, starred.

collabim_keyword_positions

History of positions. projectId + lastXDays or from+to; optionally projectKeywordIds, tags.

collabim_aggregated_keyword_positions

Aggregated keyword positions.

collabim_position_distribution

Position distribution (Top 3, 4–10, 11–20, 21+). projectId + lastXDays or from+to.

collabim_market_dominator

Market dominator values.

collabim_indexed_pages

Indexed pages of a project.

collabim_market_share

Market share. Requires projectId and searchEngineId.

Holy Grail, AI Overviews, others

collabim_holy_grail_stats / collabim_holy_grail_aio_stats / collabim_holy_grail_aio_data

Holy Grail summary stats and AIO data for a domain (not the paid organic export below).

collabim_holy_grail_organic_data

Paid Holy Grail organic keyword export for the tracked domain — maps to API GET /holy-grail-api-data/{domain}. The tool always sends charge=1: on the first page (offset 0) it creates a one-time analysis (OTA), charges credits (when data exists), and triggers the export. The response includes rows and meta (limit, offset, total, otaId, has_more, next_url). Pagination: optional limit (max 5000), offset; for offset > 0 you must pass otaId from the first response — further pages are not charged again. Optional format: json or csv.

collabim_google_ai_overviews

Google AI Overviews for a domain. Optional projectId, format.

collabim_google_ai_overviews_competitors

Google AI Competitors for a domain. Requires projectId and searchEngineId. Optional format.

collabim_google_ai_overviews_market_share

Google AI Market Share for a domain. Requires projectId and searchEngineId. Optional from, to, lastXDays, getXDays, tagName, format.

collabim_category_heureka_tree

Download Heureka categories as XLSX.

collabim_website_system

Website system detection by URL.

collabim_user_key

Get user API key by logging in (for affiliate partners).

collabim_accounts_new

Create new Collabim account (affiliate).

collabim_ota_keyword_measuring / collabim_ota_keyword_measuring_status

OTA keyword measuring (batch) and status/results.

One-time analyses

collabim_content_suggestions_start

Starts AI Content Suggestions for the given URL or domain, returns otaId.

collabim_content_suggestions_status