Гайд, Features

Grinfi MCP - Повний гайд

Квітень 7, 2026

Підключіть Claude AI до Grinfi та керуйте усім аутрічем за допомогою простих команд.

Grinfi MCP - це міст між Claude і вашим Grinfi-акаунтом. Ви пишете Claude що треба зробити, а Claude виконує це в Grinfi: знаходить контакти, запускає автоматизації, пише листи, обробляє задачі й багато іншого. Без клікання по меню та без копіпасту даних між вкладками.

Як підключити

Є три способи - залежно від того, яким продуктом Claude ви користуєтесь.

Варіант 1 - Claude.ai/Claude Desktop (браузер/додаток, без налаштувань)

  1. Відкрийте claude.ai або Claude Desktop → Settings → Connectors
  2. Натисніть Add Custom Connector та вставте https://mcp.grinfi.io
  3. Claude попросить залогінитись в ваш кабінет Grinfi через email і пароль
  4. Готово - Claude тепер має доступ до вашого Grinfi-воркспейсу

Варіант 2 - Claude Code (термінал)

Запустіть у терміналі:

claude mcp add grinfi --transport http https://mcp.grinfi.io

Claude Code відкриє вкладку браузера для OAuth-авторизації. Після входу всі інструменти доступні в терміналі.

Варіант 3 - Claude Desktop (локальна установка)

  1. Завантажте репозиторій Grinfi MCP (зелена кнопка "Code" → "Download ZIP")
  2. Отримайте API-ключ в Grinfi → Settings → API Keys
  3. Запустіть інсталятор:
    • macOS/Linux: двічі клікніть на install.sh або запустіть ./install.sh в терміналі
    • Windows: двічі клікніть на install.bat
  4. Вставте API-ключ за запитом
  5. Перезапустіть Claude Desktop

Налаштування для кількох команд: Якщо ви керуєте кількома Grinfi-воркспейсами, задайте змінну середовища GRINFI_TEAM_KEYS зі значеннями teamId:apiKey через кому. Використовуйте list_my_teams та switch_team для перемикання між командами прямо в чаті.

Що вміє Claude в Grinfi

Grinfi MCP надає Claude 158 інструментів, організованих у 17 функціональних блоків. Нижче - практичний гайд по кожному.

1. Контакти

Знаходьте, створюйте, редагуйте і керуйте лідами. Claude може знайти контакт за LinkedIn-URL, email або ім'ям - і одразу показати посилання на профіль у Grinfi та LinkedIn.

Інструменти: find_contact, get_contact, search_contacts, update_contact, delete_contact, upsert_contact, add_contact_to_automation, add_new_contact_to_automation, cancel_contact_from_automations, cancel_contact_from_all_automations, change_contact_pipeline_stage

Приклади промтів:

  • “Знайди контакт з LinkedIn linkedin.com/in/john-smith і покажи його дані”
  • “Додай John до автоматизації Q2 Outreach”
  • “Покажи всі контакти з компанії Stripe, з якими ми ще не контактували”
  • “Онови посаду Maria Garcia на VP of Engineering”
  • “Перемісти всі контакти з тегом ‘гарячий-лід’ на стейдж ‘Переговори’”

2. Компанії

Керуйте CRM - створюйте записи, шукайте по LinkedIn або сайту, збагачуйте дані, знаходьте співробітників.

Інструменти: list_companies, get_company, create_companies, update_company, delete_company, lookup_companies, search_company_leads, enrich_companies

Приклади промтів:

  • “Знайди компанію Acme Corp на LinkedIn і додай її в Grinfi”
  • “Покажи всі контакти у нашій базі, які працюють у фінансах”
  • “Збагати топ-50 компаній з нашого списку даними LinkedIn”
  • “Скільки контактів у нас є з компанії Stripe?”

3. Списки контактів

Організовуйте контакти в списки для таргетованого запуску автоматизацій.

Інструменти: list_lists, get_list, create_list, update_list, delete_list, get_list_metrics

Приклади промтів:

  • “Створи новий список ‘Series B Startups - Q2’”
  • “Скільки контактів у списку ‘Enterprise Prospects’?”
  • “Покажи всі мої списки з їхніми розмірами”

4. Автоматизації

Запускайте, зупиняйте, клонуйте і відстежуйте ефективність ваших сіквенсів. Claude може перевіряти метрики, керувати циклами автоматизацій і змінювати налаштування.

Інструменти: list_automations, get_automation, start_automation, stop_automation, archive_automation, unarchive_automation, clone_automation, update_automation, delete_automation, get_automation_metrics

Приклади промтів:

  • “Покажи всі активні автоматизації та їхній відсоток відповідей”
  • “Клонуй автоматизацію ‘Cold Outreach SaaS’ та перейменуй її на ‘Cold Outreach Fintech’”
  • “Зупини всі автоматизації, які активні більше 30 днів”
  • “Який open rate у кампанії ‘Q1 Campaign’?”
  • “Заархівуй всі автоматизації з минулого року”

5. Папки автоматизацій

Організовуйте автоматизації в папки для порядку в воркспейсі.

Інструменти: list_automation_folders, create_automation_folder, update_automation_folder, delete_automation_folder

Приклади промтів:

  • “Створи папку ‘Q2 2026 Кампанії’”
  • “Покажи всі мої папки з автоматизаціями”
  • “Перейменуй папку ‘Старі Кампанії’ на ‘Архів 2025’”

6. Задачі (ручні дії)

Переглядайте, виконуйте, пропускайте або масово обробляйте ручні задачі від автоматизацій - LinkedIn-повідомлення на перевірку, запити в контакти, email'и на погодження.

Інструменти: list_tasks, get_task, create_task, complete_task, cancel_task, fail_task, mass_complete_tasks, mass_cancel_tasks, mass_retry_tasks, mass_skip_tasks, get_tasks_group_counts, get_tasks_schedule, continue_automation

Приклади промтів:

  • “Покажи всі задачі на відправку LinkedIn-повідомлень на сьогодні”
  • “Виконай всі задачі, що очікують понад 3 дні”
  • “Заплануй LinkedIn-повідомлення Алексу Джонсону на завтра о 10:00”
  • “Скільки задач у мене в кожному статусі?”
  • “Пропусти всі задачі для контактів із компаній, з якими ми вже уклали угоду”

7. LinkedIn Браузери

Керуйте сесіями LinkedIn-браузерів, що запускають аутріч - перевіряйте статуси, запускайте/зупиняйте сесії, налаштовуйте проксі, діліться браузерами з колегами.

Інструменти: list_linkedin_browsers, get_linkedin_browser, create_linkedin_browser, delete_linkedin_browser, run_linkedin_browser, stop_linkedin_browser, set_linkedin_browser_proxy, share_linkedin_browser

Приклади промтів:

  • “Покажи всі LinkedIn-браузери та їхні статуси”
  • “Запусти браузерну сесію для сендер профайлу Анни”
  • “Зміни проксі для браузера #3 на Німеччину”
  • “Поділись браузером №5 з [email protected]”

8. Сендер Профайли

Керуйте LinkedIn та email-акаунтами, з яких ідуть розсилки. Вмикайте/вимикайте, встановлюйте розклад роботи та ліміти відправки.

Інструменти: list_sender_profiles, get_sender_profile, create_sender_profile, update_sender_profile, delete_sender_profile, enable_sender_profile, disable_sender_profile

Приклади промтів:

  • “Покажи всі сендер профайли і які з них зараз активні”
  • “Встанови робочі години для профілю Джона: понеділок-п’ятниця 9:00-18:00 за Берлінським часом”
  • “Вимкни всі сендер профайли, окрім основного”
  • “Увімкни смарт-ліміти для всіх профілів”

9. Email- та LinkedIn-повідомлення

Читайте вхідні, надсилайте відповіді, керуйте єдиним інбоксом і отримуйте контекст переписки.

Інструменти: list_emails, get_email, get_email_body, get_email_thread, get_email_llm_thread, send_email, delete_email, get_latest_emails_by_leads, list_email_bodies, get_unread_conversations, list_linkedin_messages, send_linkedin_message, delete_linkedin_message, retry_linkedin_message, mark_conversation_as_read

Приклади промтів:

  • “Покажи всі непрочитані повідомлення за сьогодні”
  • “Що відповіла Сара з Acme Corp на наше останнє повідомлення?”
  • “Підготуй і надішли follow-up лист всім лідам, хто відкрив наш email, але не відповів”
  • “Покажи повний діалог з [email protected]”
  • “Надішли LinkedIn-повідомлення пʼятьом контактам, які відповіли на нашу кампанію цього тижня”

10. Поштові скриньки

Керуйте email-акаунтами для відправки - створюйте, налаштовуйте, активуйте і діагностуйте проблеми.

Інструменти: list_mailboxes, get_mailbox, create_mailbox, update_mailbox, delete_mailbox, activate_mailbox, deactivate_mailbox, list_mailbox_errors

Приклади промтів:

  • “Покажи всі поштові скриньки та їхній статус”
  • “Чи є помилки з нашими скриньками? Покажи всі недавні проблеми”
  • “Вимкни скриньку [email protected] на час відпустки”

11. Джерела даних

Керуйте імпортами LinkedIn - контакти з пошуку Sales Navigator, LinkedIn-списків, мережі контактів, залучених з постів та ін.

Інструменти: list_data_sources, get_data_source, create_data_source, update_data_source, delete_data_source

Приклади промтів:

  • “Покажи всі активні завдання імпорту LinkedIn”
  • “Створи імпорт з моєї мережі контактів LinkedIn у список ‘Мережа 2026’”
  • “Який статус імпорту з Sales Navigator, який я запустив вчора?”

12. Теги, Етапи воронки та Кастомні змінні

Сегментуйте базу за допомогою тегів, етапів воронки та кастомних змінних.

Інструменти: list_tags, create_tag, update_tag, delete_tag, get_tag_metrics · list_pipeline_stages, create_pipeline_stage, update_pipeline_stage, delete_pipeline_stage · list_custom_fields, create_custom_field, upsert_custom_field_value

Приклади промтів:

  • “Створи тег ‘ICP - Enterprise’ зеленого кольору”
  • “Скільки лідів і компаній мають тег ‘гарячий-лід’?”
  • “Додай новий стейдж ‘Демо Заплановано’ між Engaged і Replied”
  • “Встанови кастомне поле ‘deal_size’ для Stripe 50 000 доларів”

13. AI-функції

Використовуйте вбудовані AI-агенти та темплейти Grinfi для персоналізації повідомлень, генерації змінних і власних LLM-інтеграцій.

Інструменти: list_ai_agents, get_ai_agent, list_ai_templates, get_ai_template, create_ai_template, render_ai_template, list_ai_variables, ai_ask · list_llms, get_llm, create_llm, update_llm, delete_llm, generate_llm_response, get_llm_metrics, list_llm_logs, get_llm_log

Приклади промтів:

  • “Покажи всі AI-темплейти”
  • “Згенеруй персоналізований вступний рядок для Джона Сміта з Acme Corp за темплейтом ‘Opening Line’”
  • “Додай наш OpenAI API-ключ, щоб Grinfi міг використовувати GPT-4”
  • “Скільки AI-кредитів ми використали цього місяця?”

14. Вебхуки, Нотатки, Активності та Вкладення

Повне управління воркфлоу - відстежуйте активності, додавайте нотатки, налаштовуйте івент-нотифікації, керуйте файлами.

Інструменти: list_webhooks, get_webhook, create_webhook, update_webhook, delete_webhook, test_webhook, get_webhook_metrics · list_notes, get_note, create_note, update_note, delete_note · list_activities, create_activity · list_attachments, get_attachment, upload_attachment, delete_attachment

Приклади промтів:

  • “Створи вебхук, який спрацьовує, коли контакт відповів на наше LinkedIn-повідомлення”
  • “Протестуй вебхук синхронізації з CRM і покажи відповідь”
  • “Додай нотатку до профілю Джона Сміта: ‘Зацікавлений у Enterprise-плані, подзвонити через 2 тижні’”
  • “Покажи всі активності для лідів, з якими ми контактували цього тижня”

15. Акаунт та Керування командами

Дізнайтесь про поточного користувача, переглядайте воркспейси та перемикайтесь між командами.

Інструменти: get_current_user, list_teams, get_team, list_my_teams, switch_team

Приклади промтів:

  • “До якого Grinfi-акаунта я зараз підключений?”
  • “Покажи всі мої воркспейси”
  • “Переключись на воркспейс Європейської команди”

16. Масові дії та Чорні списки

Виконуйте масові операції над сотнями контактів або компаній одночасно.

Інструменти: leads_mass_action, companies_mass_action, list_leads_blacklist, add_to_leads_blacklist, list_companies_blacklist, add_to_companies_blacklist

Приклади промтів:

  • “Додай тег ‘Q2-Follow-Up’ усім 300 контактам зі списку ‘Учасники вебінару’”
  • “Перемісти всіх контактів зі списку ‘Churned’ на стейдж ‘Програно’”
  • “Додай competitor.com до чорного списку компаній, щоб ми більше не контактували з їхніми співробітниками”
  • “Видали всі контакти, імпортовані до січня 2025, які жодного разу не відповіли”

17. Збагачення даних та Домени відстеження

Моніторинг збагачення даних LinkedIn та управління кастомними доменами для трекінгу email.

Інструменти: list_enrichment_queue, get_enrichment_metrics · list_custom_tracking_domains, get_custom_tracking_domain, create_custom_tracking_domain

Приклади реальних сценаріїв

Це повноцінні багатокрокові воркфлоу, які можна описати Claude в одному повідомленні:

Ранковий огляд:

“Перевір непрочитані розмови, покажи задачі на сьогодні та які автоматизації мали відповіді за останні 24 години”

Запуск нової кампанії:

“Клонуй автоматизацію ‘SaaS Cold Outreach’, перейменуй на ‘Fintech Q2 2026’, перемісти в папку ‘Q2 Кампанії’, потім додай всі контакти зі списку ‘Series B Fintech’ до неї”

Дослідження відповіді:

“Знайди контакт, який відповів на нашу кампанію сьогодні, покажи повну історію листування, дані компанії, поточний стейдж і нотатки на профілі”

Масове очищення:

“Знайди всі контакти зі списку ‘Старі ліди 2024’, з якими ми жодного разу не контактували, додай тег ‘архів-2024’, перемісти на стейдж ‘Заархівовано’ та видали з усіх активних автоматизацій”

Налаштування нового сендер профайлу:

“Створи сендер профайл для Anna Müller, встанови робочі години пн-пт 8:00-17:00 за Берлінським часом зі смарт-лімітами, потім підключи LinkedIn-браузер з Німецьким проксі”

Поради для кращих результатів

  • Називайте точно - якщо є кілька автоматизацій зі схожими назвами, вказуйте ключові слова для уточнення
  • Claude памʼятає контекст - у рамках однієї розмови Claude знає, які контакти, автоматизації або дані вже обговорювались
  • Просіть підтвердження для небезпечних дій - Claude запитає перед видаленням контактів або зупинкою активних автоматизацій
  • Комбінуйте дії природно - можна попросити знайти щось і одразу діяти на підставі результату в одному повідомленні

Посилання