Payhawk документацията е в процес на превод. През това време част от статиите и свързаните ресурси ще са на български, а други на английски. Благодарим за търпението!

Свързване на Payhawk с вашия AI асистент

Prev Next

MCP на Payhawk свързва акаунта ви в Payhawk с AI асистента ви, за да можете да задавате въпроси за актуалните си данни в Payhawk и да действате върху тях в AI асистента, който вече използвате, като Claude, ChatGPT или Cursor, като използвате собствените си данни за вход и разрешения.

Преди да започнете

За да свържете MCP на Payhawk, трябва да имате:

  • Активен акаунт в Payhawk. Влезте със същите идентификационни данни, които използвате за уеб портала на Payhawk.

  • URL адреса на MCP сървъра на Payhawk (https://mcp.payhawk.com/mcp, достъпен и в следващите раздели).

Всеки влиза със собствените си данни за вход в Payhawk, така че всички запазват собствените си разрешения в Payhawk. Връзката остава активна, докато я използвате. Ако не я използвате 7 дни, трябва да влезете отново, а във всички случаи повторно влизане се изисква на всеки 30 дни.

Поддържани AI асистенти

В следващата таблица са изброени AI асистентите, които MCP на Payhawk поддържа:

AI асистент

Разработчик

Полезно е да знаете

Claude

Anthropic

Уеб версия, настолно и мобилно приложение. Включен в директорията с конектори на Claude. При план Team или Enterprise акаунт на собственик в Claude трябва първо да активира Payhawk.

Claude Code

Anthropic

Настройва се в терминал.

ChatGPT

OpenAI

Включен в директорията с плъгини на ChatGPT, при всеки план, включително Free.

Codex CLI

OpenAI

Настройва се в терминал. За настолното приложение Codex следвайте стъпките за ChatGPT. Компонентите на потребителския интерфейс се показват като текст.

Cursor

Anysphere

Настройва се във файла mcp.json.

Приложение GitHub Copilot

GitHub

GitHub Copilot във VS Code

GitHub

Настройва се от менюто с команди.

Microsoft Copilot Studio

Microsoft

Microsoft 365 Copilot

Microsoft

Администратор на Microsoft 365 трябва да одобри агента на Payhawk.

Langdock

Langdock

Notion

Notion

Dust

Dust

Payhawk приема влизания само от AI асистентите в таблицата. Във всяко друго приложение влизането е неуспешно с грешка, която съдържа host-not-allowed или „The client redirect URI is not allowed“ („URI адресът за пренасочване на клиента не е разрешен“). За да поискате поддръжка за друго приложение, свържете се с Екипа за поддръжка на Payhawk на support@payhawk.com.

Свързване с Claude

Claude поддържа MCP на Payhawk в уеб версията, в настолното приложение и в мобилното приложение.

Можете да свържете Payhawk от директорията с конектори на Claude:

  1. Отворете страницата на Payhawk в Claude Marketplace.

  2. Кликнете върху Add to Claude (Добавяне към Claude) и следвайте указанията, за да се свържете.

  3. Влезте с идентификационните данни, които използвате за уеб портала на Payhawk, и одобрете връзката.

Ако използвате Claude с план Team или Enterprise, акаунт на собственик в Claude трябва първо да активира конектора. След това всеки се свързва със собствения си вход в Payhawk и запазва собствените си разрешения в Payhawk.

Можете също да добавите Payhawk като персонализиран конектор чрез URL адреса на MCP сървъра на Payhawk.

Първо проверете дали можете сами да добавяте конектори.

  • Персонализираните конектори работят при всеки абонаментен план на Claude (Free, Pro, Max, Team и Enterprise; при Free се допуска един), така че планът рядко е пречката.

  • При личен акаунт Free, Pro или Max можете сами да добавите Payhawk.

  • В работно пространство Team или Enterprise само акаунт на собственик в Claude може да добави персонализиран конектор, затова помолете вашия да добави Payhawk веднъж, след което всеки се свързва с него поотделно. Дали сте Администратор на Payhawk няма значение тук – това е разрешение на Claude, не на Payhawk.

Ако го добавяте сами (Free, Pro, Max):

  1. В настолното приложение Claude отидете на Settings (Настройки) > Connectors (Конектори).

  2. Кликнете върху Add custom connector (Добавяне на персонализиран конектор).

  3. Въведете име, например Payhawk, и URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  4. Оставете опциите, които Claude отбелязва като Detected (Открито): Sign in now (Влизане сега) под Authentication (Удостоверяване) и Register automatically (Автоматична регистрация) под OAuth client (OAuth клиент).

  5. Влезте с идентификационните си данни за Payhawk, когато бъдете подканени.

Можете да добавите Payhawk и от мобилното приложение Claude, от същия екран.

Ако го добавя акаунтът на собственик в Claude (Team, Enterprise):

  1. Акаунтът на собственик отива на Organization settings (Настройки на организацията) > Connectors (Конектори), кликва върху Add (Добавяне), задържа курсора върху Custom (Персонализиран) и избира Web (Уеб).

  2. Акаунтът на собственик поставя https://mcp.payhawk.com/mcp – URL адреса на MCP сървъра на Payhawk, и кликва върху Add (Добавяне).

  3. Всички останали отиват на Settings (Настройки) > Connectors (Конектори), намират Payhawk, кликват върху Connect (Свързване) и влизат с личните си данни за вход в Payhawk. Всеки влиза със своя акаунт, така че всички запазват собствените си разрешения в Payhawk.

Payhawk вече се появява в инструментите на Claude.

Свързване с Claude Code

За да свържете Payhawk с Claude Code:

  1. В терминал изпълнете claude mcp add --transport http payhawk https://mcp.payhawk.com/mcp. За да направите Payhawk достъпен във всичките си проекти, а не само в текущия, добавете --scope user.

  2. Стартирайте Claude Code и въведете /mcp.

  3. Изберете payhawk и следвайте стъпките в браузъра, за да влезете с данните си за вход в Payhawk.

Можете също да влезете от терминала с claude mcp login payhawk и да излезете с claude mcp logout payhawk.

Неинтерактивните изпълнения (claude -p) не могат да завършат влизането, затова първо влезте веднъж от интерактивна сесия. Ако премахнете сървъра с claude mcp remove payhawk, запазеното ви влизане също се премахва.

Свързване с ChatGPT

Можете да свържете Payhawk от директорията с плъгини на ChatGPT, включително при плана Free:

  1. Отворете страницата на Payhawk в директорията с плъгини на ChatGPT.

  2. Следвайте указанията, за да инсталирате Payhawk и да свържете акаунта си.

  3. Влезте с идентификационните данни, които използвате за уеб портала на Payhawk, и одобрете връзката.

След като се свържете, можете да питате ChatGPT за данните си в Payhawk и да извършвате действия в рамките на разрешенията си в Payhawk.

Можете също да добавите Payhawk в настолното приложение ChatGPT чрез URL адреса на MCP сървъра на Payhawk:

  1. В настолното приложение ChatGPT отидете на Settings (Настройки) > Plugins (Плъгини) > Add (Добавяне) > Add MCP server (Добавяне на MCP сървър).

  2. Въведете име, например Payhawk.

  3. Изберете Streamable HTTP и поставете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  4. Влезте с идентификационните си данни за Payhawk, когато бъдете подканени.

Свързване с Codex

Настолното приложение Codex вече е част от настолното приложение ChatGPT. За да използвате Payhawk там, следвайте стъпките за ChatGPT. За да свържете Payhawk с Codex CLI (инструмента за команден ред):

  1. В терминал изпълнете codex mcp add payhawk --url https://mcp.payhawk.com/mcp.

  2. Изпълнете codex mcp login payhawk.

  3. Влезте с идентификационните си данни за Payhawk в прозореца на браузъра, който се отваря.

Компоненти на потребителския интерфейс, като изпълними модули за полети или одобрения, не се визуализират в Codex. Отговорът се получава като текст.

Свързване с Cursor

За да свържете Payhawk с Cursor:

  1. В Cursor отидете на Customize (Персонализиране) > MCPs > New MCP Server (Нов MCP сървър). Cursor отваря файла ви mcp.json.

  2. Добавете Payhawk в "mcpServers", както в следващия пример. Ако файлът вече съдържа други сървъри, добавете запетая след предишния запис.

    {
      "mcpServers": {
        "payhawk": { "url": "https://mcp.payhawk.com/mcp" }
      }
    }
  3. Запазете файла и се върнете в Customize (Персонализиране) > MCPs.

  4. Под Needs Attention (Изисква внимание) кликнете върху Authenticate (Удостоверяване) до Payhawk и влезте с идентификационните си данни за Payhawk.

Payhawk вече се появява под Connected (Свързани).

Свързване с приложението GitHub Copilot

За да свържете Payhawk с приложението GitHub Copilot:

  1. В приложението GitHub Copilot отидете на Customize (Персонализиране) > Installed (Инсталирани).

  2. До MCP Servers (MCP сървъри) кликнете върху Add server (Добавяне на сървър) > Add custom server (Добавяне на персонализиран сървър).

  3. В Server name (Име на сървъра) въведете име, например payhawk.

  4. В Server type (Тип сървър) изберете HTTP.

  5. В URL поставете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  6. Оставете Headers (Заглавки), OAuth Client ID (ИД на OAuth клиент) и Timeout (Време за изчакване) празни и кликнете върху Add server (Добавяне на сървър).

  7. Влезте с идентификационните си данни за Payhawk, когато бъдете подканени.

Свързване с GitHub Copilot във VS Code

За да свържете Payhawk с GitHub Copilot във VS Code:

  1. Във VS Code отворете Command Palette (командната палитра) с Cmd+Shift+P на Mac или Ctrl+Shift+P на Windows и изпълнете MCP: Add Server (MCP: Добавяне на сървър).

  2. Изберете HTTP.

  3. Поставете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  4. Въведете име, например Payhawk Customer MCP.

  5. Изберете Global (Глобално) или Workspace (Работно пространство).

VS Code добавя Payhawk към файла ви mcp-config.json, както в следващия пример:

{
  "mcpServers": {
    "Payhawk Customer MCP": {
      "type": "http",
      "url": "https://mcp.payhawk.com/mcp",
      "tools": ["*"]
    }
  }
}

Свързване с Microsoft Copilot Studio

За да свържете Payhawk с Microsoft Copilot Studio:

  1. В Copilot Studio отидете на Tools (Инструменти) и кликнете върху New tool (Нов инструмент).

  2. Изберете Model Context Protocol.

  3. Попълнете задължителните полета: име в Server name (Име на сървъра), например Payhawk MCP, описание в Server description (Описание на сървъра) и URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp в Server URL (URL адрес на сървъра).

  4. В Authentication (Удостоверяване) изберете OAuth 2.0, а в Type (Тип) изберете Dynamic discovery (Динамично откриване).

  5. Кликнете върху Create (Създаване).

Payhawk вече се появява в списъка ви с инструменти.

Свързване с Microsoft 365 Copilot

Microsoft 365 Copilot няма опция за добавяне на конектор. Вместо това пакетирате Payhawk като агент във VS Code и го публикувате във вашата организация.

Какво ви е необходимо

За да публикувате Payhawk в Microsoft 365 Copilot, трябва да имате:

  • Служебен акаунт в Microsoft 365. Личните акаунти в Microsoft не работят.

  • Глобален администратор или администратор на Teams в Microsoft 365 за стъпките за одобрение.

  • Visual Studio Code с разширението Microsoft 365 Agents Toolkit, версия 6.12.0 или по-нова.

Разрешаване на персонализирани приложения (еднократно, от администратор)

В центъра за администриране на Teams:

  1. Отидете на Teams apps (Приложения на Teams) > Setup policies (Правила за настройка) > Global (Org-wide default) (Глобално (по подразбиране за цялата организация)), включете Upload custom apps (Качване на персонализирани приложения) и кликнете върху Save (Запазване).

  2. Отидете на Teams apps (Приложения на Teams) > Manage apps (Управление на приложения) > Actions (Действия) > Org-wide app settings (Настройки на приложенията за цялата организация), включете Let users interact with custom apps in preview (Разрешаване на потребителите да работят с персонализирани приложения във визуализация) и кликнете върху Save (Запазване).

Прилагането на промените може да отнеме до 24 часа.

Създаване на агента във VS Code

За да създадете агента на Payhawk:

  1. Във VS Code кликнете върху иконата Microsoft 365 Agents Toolkit в лявата лента.

  2. Кликнете върху Create a New Agent/App (Създаване на нов агент или приложение) > Declarative Agent (Декларативен агент) > Add an Action (Добавяне на действие) > Start with an MCP Server (Започване с MCP сървър).

  3. За URL адрес на сървъра въведете https://mcp.payhawk.com/mcp.

  4. За удостоверяване изберете OAuth (with dynamic registration) (OAuth (с динамична регистрация)).

  5. Изберете папка за проекта и наименувайте агента, например Payhawk.

  6. В новия прозорец на VS Code кликнете върху Trust (Доверяване). Ако сте пропуснали подканата, кликнете върху Restricted Mode (Ограничен режим) в лентата на състоянието и след това върху Trust (Доверяване).

Задаване на име и описание

Задайте истинско име и описание на агента. Ако пропуснете тази стъпка, потребителите виждат примерен текст и наставка „dev“ в името.

  1. В appPackage/manifest.json заменете примерните стойности на developer.name, name.full, description.short и description.full.

  2. В appPackage/declarativeAgent.json заменете description.

  3. Създайте файла env/.env.prod със следното съдържание:

TEAMSFX_ENV=prod
APP_NAME_SUFFIX=

Публикуване на агента

За да изпратите агента на администратора си за одобрение:

  1. В панела Lifecycle (Жизнен цикъл) кликнете върху Provision (Подготвяне) и изберете prod.

  2. Кликнете върху Publish (Публикуване) и изберете prod.

Одобряване на агента (от администратор)

В центъра за администриране на Microsoft 365:

  1. Отидете на Agents (Агенти) > All agents (Всички агенти) > Requests (Заявки).

  2. Отворете агента на Payhawk и кликнете върху Publish to store (Публикуване в магазина).

  3. Под Select users or groups who can install the agent (Избор на потребители или групи, които могат да инсталират агента) изберете All users (Всички потребители) или конкретни групи. Можете също да изберете кои потребители да получат агента предварително инсталиран в страничната си лента.

  4. Приемете политиката за сигурност по подразбиране, прегледайте разрешенията и кликнете върху Publish (Публикуване).

Ако стъпката с политиката за сигурност не спира да се зарежда, одобрете агента в центъра за администриране на Teams: отидете на Teams apps (Приложения на Teams) > Manage apps (Управление на приложения), намерете агента на Payhawk и го публикувайте или разрешете.

След това потребителите отварят Payhawk под Agents (Агенти) в страничната лента на Copilot. Първия път, когато зададат въпрос, кликват върху Sign in (Вход), влизат с идентификационните си данни за Payhawk и одобряват достъпа.

Свързване с Langdock

За да свържете Payhawk с Langdock:

  1. В Langdock отидете на Integrations (Интеграции) > Create (Създаване) > Integration (Интеграция).

  2. Изберете Connect remote MCP (Свързване на отдалечен MCP).

  3. В Server URL (URL адрес на сървъра) поставете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  4. В Authentication method (Метод за удостоверяване) изберете OAuth 2.0 (Dynamic Client Registration) (OAuth 2.0 (динамична регистрация на клиента)).

  5. Влезте с идентификационните си данни за Payhawk, когато бъдете подканени.

Свързване с Notion

За да свържете Payhawk с Notion:

  1. В Notion отидете на Settings (Настройки) > Connections (Връзки).

  2. Кликнете върху + Add connection (+ Добавяне на връзка) > Custom MCP connection (Персонализирана MCP връзка).

  3. В MCP server URL (URL адрес на MCP сървъра) въведете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp, а в Name (Име) въведете име, например Payhawk.

  4. В Authentication (Удостоверяване) изберете OAuth.

  5. Кликнете върху Connect (Свързване). Notion показва съобщение, че не е проверил този сървър, което е нормално за персонализирани сървъри.

  6. Когато Notion ви пренасочи към Payhawk, влезте с идентификационните си данни за Payhawk.

Свързване с Dust

За да свържете Payhawk с Dust:

  1. В Dust отидете на Spaces (Пространства) > Tools (Инструменти) и кликнете върху Add tools (Добавяне на инструменти).

  2. Кликнете върху Add MCP server (Добавяне на MCP сървър).

  3. В URL поставете URL адреса на MCP сървъра на Payhawk https://mcp.payhawk.com/mcp.

  4. Оставете Authentication (Удостоверяване) на Automatic (Автоматично) и кликнете върху Save (Запазване).

Payhawk вече се появява в списъка ви с инструменти.

След свързване на Payhawk с AI асистента

След като ги свържете, можете да задавате въпроси за разходи, фактури, картови транзакции, доставчици и бюджети, а също така можете да искате от AI асистента да извършва действия, като повторно категоризиране на разходи, одобряване на елементи, замразяване на карти и създаване на заявки. При всяка промяна се показва предварителен преглед и се изчаква изричното ви потвърждение.

За повече практическа информация вижте статията за извличане на максимума от MCP на Payhawk.