Кратко
Дайте ИИ работать с вашим бизнес-аккаунтом PayPal: создавать заказы и списывать по ним оплату, возвращать платежи, создавать и отправлять счета и напоминать о них, искать в истории транзакций и балансах, просматривать споры, а также смотреть планы подписок, подписки и пакеты выплат. Песочница (sandbox) или рабочий режим, с ключами вашего собственного REST-приложения.
Пошаговая настройка
Подключи PayPal к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи PayPal в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для PayPal
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → PayPal, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
PayPal + Microsoft Copilot
Дайте ИИ работать с вашим бизнес-аккаунтом PayPal: создавать заказы и списывать по ним оплату, возвращать платежи, создавать и отправлять счета и напоминать о них, искать в истории транзакций и балансах, просматривать споры, а также смотреть планы подписок, подписки и пакеты выплат. Песочница (sandbox) или рабочий режим, с ключами вашего собственного REST-приложения.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_API_URL
Шаг 1 — Получите учётные данные
- Войдите на developer.paypal.com с бизнес-аккаунтом PayPal и откройте Apps & Credentials. Переключатель вверху меняет режим между Sandbox и Live; у каждого свои приложения и ключи.
- Возьмите Default Application или нажмите Create App, выберите тип Merchant и, в песочнице, тестовый бизнес-аккаунт, от имени которого будет работать приложение.
- Откройте приложение и в его функциях отметьте то, к чему ИИ должен иметь доступ: Invoicing, Transaction Search, Subscriptions (включает и товары каталога), Customer Disputes и Payouts.
- Скопируйте Client ID в
PAYPAL_CLIENT_ID, а Secret key 1 (нажмите, чтобы показать) вPAYPAL_CLIENT_SECRET. Оба значения должны быть из одного приложения и из одного раздела, Sandbox или Live. - Укажите в
PAYPAL_API_URLадресhttps://api-m.sandbox.paypal.comдля ключей песочницы илиhttps://api-m.paypal.comдля рабочих ключей, без косой черты в конце. - Установите коннектор. Шага Authorize with Provider и окна согласия PayPal нет: коннектор входит как ваше REST-приложение по client ID и secret.
- Начните с
paypal_get_balancesи проверьте, что ключи ведут к нужному аккаунту (для этого у приложения должна быть включена Transaction Search).
Как не потерять авторизацию: коннектор сам получает токены доступа по client ID и secret и обновляет их до истечения срока, так что входить заново не нужно.
Новые функции включаются не сразу: если приложение уже выдавало токены, PayPal может включать для него новую отмеченную функцию до 9 часов. До этого такие вызовы отвечают 403 NOT_AUTHORIZED, поэтому отметьте всё нужное до первой установки.
Платежи и письма: paypal_capture_order, paypal_refund_capture и paypal_cancel_subscription двигают или останавливают реальные деньги на рабочем аккаунте, а paypal_send_invoice, paypal_remind_invoice и paypal_cancel_invoice отправляют клиенту письмо. ИИ заранее точно называет, что произойдёт (сумма, валюта, клиент, идентификаторы), и ждёт вашего согласия. Списания и возвраты передаются с идентификатором запроса, поэтому повторная попытка не выполнит их дважды.
Разрешения и режим только для чтения: приложению доступны только отмеченные функции, поэтому не отмечайте то, чем ИИ пользоваться не должен. Для режима только для чтения отключите paypal_create_order, paypal_capture_order, paypal_refund_capture, paypal_create_draft_invoice, paypal_send_invoice, paypal_remind_invoice, paypal_cancel_invoice и paypal_cancel_subscription. С ключами песочницы можно сначала безопасно всё опробовать.
Выключены при установке: paypal_delete_draft_invoice, который безвозвратно удаляет черновик или запланированный счёт. Включайте его, только если ИИ должен удалять черновики; отправленные счета вместо этого отменяются через paypal_cancel_invoice.
Заказы и возвраты: paypal_create_order ничего не списывает. Он возвращает ссылку, которую покупатель должен открыть и подтвердить; только после этого paypal_capture_order может списать деньги. paypal_refund_capture возвращает списание полностью или, если указать сумму, частично, но не больше остатка после прежних возвратов.
Счета и история: paypal_create_draft_invoice ничего не отправляет, пока paypal_send_invoice не отправит счёт, а напоминаний PayPal разрешает не больше 2 в день. paypal_search_transactions охватывает не более 31 дня за вызов (более длинные периоды запрашиваются помесячно) и доходит до 3 лет назад; новые транзакции и балансы появляются с задержкой до 3 часов. Споры доступны за последние 180 дней.
Частые ошибки: 401 invalid_client или invalid_token означает неверный client ID или secret либо ключи не из той среды, что указана в PAYPAL_API_URL (ключам песочницы нужен адрес песочницы, рабочим ключам рабочий адрес). 403 NOT_AUTHORIZED или PERMISSION_DENIED означает, что функция не отмечена в приложении или отмечена меньше 9 часов назад. 422 UNPROCESSABLE_ENTITY называет нарушенное бизнес-правило, например ORDER_NOT_APPROVED (покупатель ещё не подтвердил заказ), AMOUNT_MISMATCH или CAPTURE_FULLY_REFUNDED. 429 RATE_LIMIT_REACHED означает, что PayPal ограничивает запросы приложения: подождите минуту и повторите.
Коннектор не работает с оплатой картами и сохранением платёжных данных (vaulting), вебхуками, отправкой выплат, принятием споров и ответами на них, а также не редактирует планы подписок.
Шаг 2 — Установите адаптер
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Шаг 3 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
PayPal. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Tool | What it does |
|---|---|
paypal_create_order | Create a checkout order (nothing is charged yet) |
paypal_get_order | Read one checkout order: status (CREATED, APPROVED, COMPLETED, VOIDED, ...), amounts, payer, and for completed orders the captures under… |
paypal_capture_order | Collect the money of an order the buyer has approved (intent CAPTURE) |
paypal_get_capture | Read one captured payment: amount, status (COMPLETED, PENDING, PARTIALLY_REFUNDED, REFUNDED, DECLINED), seller fees and net amount, and… |
paypal_refund_capture | Refund a captured payment, in full (no amount) or in part |
paypal_get_refund | Read one refund: amount, status (COMPLETED, PENDING, FAILED, CANCELLED), note to the payer and the capture it belongs to |
paypal_get_authorization | Read one authorized payment (an order created with intent AUTHORIZE): amount, status (CREATED, CAPTURED, PARTIALLY_CAPTURED, VOIDED… |
paypal_list_invoices | List invoices, newest first, with id, number, status, recipient, amount and due date |
paypal_search_invoices | Search invoices by recipient, number, status, currency, dates or amount (all filters combined with AND) |
paypal_create_draft_invoice | Create a draft invoice |
paypal_get_invoice | Read one invoice: status, recipient, items, amounts, due amount, payments and refunds recorded on it, and the payer link (links[] rel… |
paypal_send_invoice | Send a draft invoice |
paypal_remind_invoice | Email a payment reminder for a sent, unpaid invoice (PayPal allows 2 reminders a day) |
paypal_cancel_invoice | Cancel a sent invoice so it can no longer be paid; by default the recipient is told by email |
paypal_delete_draft_invoice | Delete a draft or scheduled invoice for good (sent invoices are cancelled with paypal_cancel_invoice instead) |
paypal_search_transactions | Search the account history (Transaction Search): payments received and sent, refunds, fees, transfers and their payer and cart details |
paypal_get_balances | Read the account balances per currency (available, withheld and total), now or as of a past time: balances[] with as_of_time |
paypal_list_disputes | List disputes, claims and chargebacks raised against the account (last 180 days), with dispute_id, reason, status, dispute_state, amount… |
paypal_get_dispute | Read one dispute in full: reason, status, amounts, disputed transactions, messages, offers, evidence and the deadline to respond… |
paypal_list_products | List catalog products (the products subscription plans belong to): id, name, description, type and dates |
paypal_get_product | Read one catalog product: name, description, type (PHYSICAL, DIGITAL, SERVICE), category, image and home URLs |
paypal_list_plans | List subscription plans, optionally for one product: id, name, status (CREATED, ACTIVE, INACTIVE), product_id and dates |
paypal_get_plan | Read one subscription plan: billing cycles with prices and frequency, trial periods, setup fee, taxes and payment failure settings |
paypal_list_subscriptions | List subscriptions, filtered by plan and status: id, status, plan_id, subscriber, start time and next billing time |
paypal_get_subscription | Read one subscription: status, plan, subscriber (name, email, shipping address), billing info (outstanding balance, last payment, next… |
paypal_list_subscription_transactions | List the payments of one subscription between two times: id, status, amounts with fees and net, payer and time |
paypal_cancel_subscription | Cancel a subscription for good: no further payments are collected and it cannot be reactivated |
paypal_get_payout_batch | Read one payout batch: batch status and totals, and its items (receiver, amount, status, fees, errors) |
Примеры запросов
- «Какой у меня сейчас баланс в PayPal и какие платежи пришли за последние 7 дней?»
- «Создай черновик счёта для Acme Ltd: 10 часов консультаций по 90 EUR, оплата в течение 30 дней. Покажи его мне перед отправкой.»
- «Какие споры ждут моего ответа и до какого срока нужно ответить по каждому?»
- «Покажи активные подписки на план Pro Monthly и скажи, у каких из них были неудачные платежи.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?