Руководство по MCP-серверу PandaDoc

Файлы конфигурации и инструменты для интеграции PandaDoc с LLM и агентными фреймворками.

PandaDoc размещает удалённый MCP-сервер по адресу https://mcp.pandadoc.com/v1/mcp. Это обеспечивает безопасный доступ MCP-клиентов через OAuth. Документацию см. здесь.

[!NOTE] Лимиты и ограничения на создание, отправку и другие операции с документами PandaDoc также применяются к MCP-серверу PandaDoc.

Существующие ограничения скорости для Public API PandaDoc также применяются к инструментам MCP-сервера PandaDoc. Дополнительная информация об ограничениях Public API доступна по адресу: https://developers.pandadoc.com/reference/limits

Содержание

• Установка и настройка

  • Claude Desktop

  • Claude Code

  • Cline

  • OpenCode

  • Codex

  • Kiro

  • Cursor

  • VS Code

  • Gemini (на базе Gemini CLI)

• Поддержка и конфиденциальность

• Лицензия

Related MCP server: mcp-Docuplete

Установка и настройка

Разные MCP-клиенты требуют несколько разных настроек. Следуйте инструкциям ниже для вашего конкретного клиента, чтобы подключиться к MCP-серверу PandaDoc.

Claude Desktop

Чтобы настроить MCP-сервер PandaDoc в Claude Desktop:

1. Откройте Claude Desktop и перейдите в "Customize" → "Connectors".

2. Нажмите кнопку "+", затем выберите "... Add custom connector".

3. На экране "Add custom connector" введите:

   • Имя: PandaDoc

   • URL удалённого MCP-сервера: https://mcp.pandadoc.com/v1/mcp

   • Нажмите Add

4. Нажмите Connect, чтобы начать процесс аутентификации. Откроется внешняя страница.

5. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

6. Нажмите Authorize, чтобы пройти аутентификацию и разрешить Claude доступ к вашей учётной записи PandaDoc.

7. После завершения аутентификации вы должны увидеть предупреждение. Нажмите "Open Claude", чтобы вернуться в Claude Desktop.

8. Вернувшись в приложение Claude, вы должны увидеть PandaDoc в списке пользовательских коннекторов, и вы готовы начать работу с запросами в Claude.

Claude Code

Чтобы настроить MCP-сервер PandaDoc в Claude Code:

1. Откройте терминал, выполните следующую команду, затем нажмите Enter: claude mcp add pandadoc --transport http https://mcp.pandadoc.com/v1/mcp

2. Введите claude, чтобы запустить Claude Code.

3. Введите /mcp и нажмите Enter, чтобы открыть список установленных MCP-серверов.

4. С помощью стрелок перейдите к серверу PandaDoc и нажмите Enter, чтобы начать процесс аутентификации. Откроется внешняя страница.

5. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

6. Нажмите Authorize, чтобы пройти аутентификацию и разрешить Claude Code доступ к вашей учётной записи PandaDoc.

7. После завершения аутентификации вернитесь в терминал и снова выполните команду /mcp.

8. Сервер PandaDoc теперь должен отображаться как подключённый, и вы готовы начать работу с запросами в Claude Code.

Cline

Чтобы настроить MCP-сервер PandaDoc с Cline:

1. Установите или обновите CLI Cline:

   npm install -g cline

2. Откройте терминал и запустите мастер установки MCP Cline:

   cline mcp add pandadoc --transport streamable-http https://mcp.pandadoc.com/v1/mcp

3. Проверьте предварительно заполненные данные сервера в мастере и завершите настройку.

4. Когда появится запрос, перейдите к PandaDoc в браузере для аутентификации.

5. Нажмите Allow access, затем Authorize, чтобы разрешить Cline доступ к вашей учётной записи PandaDoc.

6. После аутентификации вернитесь в Cline и убедитесь, что сервер PandaDoc подключён.

Вы можете в любой момент снова открыть интерфейс управления MCP, выполнив cline mcp.

Никакой локальный пакет PandaDoc, исходный код, API-ключ или переменная окружения не требуются. Аутентификация выполняется через OAuth PandaDoc.

OpenCode

Чтобы настроить MCP-сервер PandaDoc в OpenCode:

1. Откройте терминал и выполните: opencode mcp add

2. Нажмите Enter, чтобы начать процесс.

3. Когда OpenCode запросит имя MCP-сервера, введите pandadoc и нажмите Enter.

4. Когда OpenCode запросит тип MCP-сервера, с помощью стрелок выберите "Remote" и нажмите Enter.

5. Когда OpenCode запросит URL MCP-сервера, введите https://mcp.pandadoc.com/v1/mcp и нажмите Enter.

6. Когда OpenCode спросит, требует ли сервер аутентификацию OAuth, выберите "Yes" и нажмите Enter.

7. Когда OpenCode спросит "Do you have a pre-registered client ID?", выберите "No" и нажмите Enter.

8. OpenCode должен завершить работу с сообщением: "MCP server added successfully".

9. Выполните аутентификацию с вашей учётной записью PandaDoc, запустив: opencode mcp auth pandadoc

10. Нажмите Enter, чтобы начать процесс аутентификации. Откроется внешняя страница.

11. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

12. Нажмите Authorize, чтобы пройти аутентификацию и разрешить OpenCode доступ к вашей учётной записи PandaDoc.

13. После завершения аутентификации вернитесь в терминал и запустите OpenCode командой opencode.

14. В OpenCode введите /mcp в строке ввода и нажмите Enter.

15. Вы должны увидеть "pandadoc" в списке как "connected".

16. Нажмите ESC, и вы готовы начать работу с запросами в OpenCode.

Codex

Чтобы настроить MCP-сервер PandaDoc в Codex desktop:

1. Откройте Codex и нажмите "Settings → Settings" в левом нижнем углу.

2. В окне настроек выберите "MCP servers".

3. В списке MCP-серверов выберите "+ Add server".

4. На экране "Connect to a custom MCP" введите:

   • Имя: PandaDoc

   • Выберите "Streamable HTTP"

   • URL: https://mcp.pandadoc.com/v1/mcp

5. Нажмите Save.

6. Вернувшись в список MCP-серверов, рядом со значком шестерёнки должна появиться кнопка "Authenticate". Нажмите её, чтобы начать процесс аутентификации. Откроется внешняя страница.

7. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

8. Нажмите Authorize, чтобы пройти аутентификацию и разрешить Codex доступ к вашей учётной записи PandaDoc.

9. После завершения аутентификации вернитесь в окно Codex, и вы готовы начать работу с запросами в Codex.

Kiro

Чтобы установить power PandaDoc из его публичного репозитория GitHub:

1. Откройте панель Powers и выберите Add Custom Power.

2. Выберите Import power from GitHub.

3. Введите https://github.com/PandaDoc/mcp-server-guide и нажмите Install.

4. Попросите Kiro выполнить задачу PandaDoc и завершите процесс OAuth PandaDoc, когда появится запрос.

Cursor

Чтобы настроить MCP-сервер PandaDoc в Cursor:

1. Откройте палитру команд:

   • macOS: CMD + Shift + P

   • Windows/Linux: CTRL + Shift + P

2. В списке выберите "View: Open MCP Settings" и нажмите Enter.

3. Выберите "Tools & MCPs".

4. В разделе "Installed MCP Servers" нажмите кнопку "New MCP Server".

5. Должен открыться файл mcp.json. Добавьте MCP-сервер PandaDoc в объект mcpServers. Это должно выглядеть так:

   {
     "mcpServers": {
       "pandadoc": {
         "url": "https://mcp.pandadoc.com/v1/mcp"
       }
     }
   }

   Примечание: если у вас уже был настроен MCP-сервер, убедитесь, что запятые стоят в правильных местах, например:

   {
     "mcpServers": {
       "mcp-sample-server": {
         "url": "https://mcp.sample.server.com/mcp"
       },
       "pandadoc": {
         "url": "https://mcp.pandadoc.com/v1/mcp"
       }
     }
   }

6. Сохраните файл и вернитесь на предыдущий экран "Tools & MCPs".

7. Должна появиться кнопка "Authenticate". Нажмите её, чтобы начать процесс аутентификации. Откроется внешняя страница.

8. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

9. Нажмите Authorize, чтобы пройти аутентификацию и разрешить Cursor доступ к вашей учётной записи PandaDoc.

10. После завершения аутентификации вернитесь в приложение Cursor, и вы готовы начать работу.

VS Code

Чтобы настроить MCP-сервер PandaDoc в VS Code:

1. Убедитесь, что у вас включён GitHub Copilot.

2. Откройте палитру команд и выберите "MCP: Add server...":

   • macOS: CMD + Shift + P

   • Windows/Linux: CTRL + Shift + P

3. Выберите HTTP.

4. Вставьте URL сервера https://mcp.pandadoc.com/v1/mcp в строку поиска, затем нажмите Enter.

5. Введите PandaDoc, когда будет запрошен идентификатор сервера, затем нажмите Enter.

6. Должен отобразиться ваш файл mcp.json с конфигурацией MCP-сервера PandaDoc.

7. VS Code покажет предупреждение с запросом на аутентификацию. Нажмите кнопку Allow.

8. Появится ещё одно предупреждение с URL. Нажмите кнопку Open, чтобы начать процесс аутентификации. Откроется внешняя страница.

9. Нажмите Allow access, чтобы дать согласие и начать процесс аутентификации с PandaDoc.

10. Нажмите Authorize, чтобы пройти аутентификацию и разрешить VS Code доступ к вашей учётной записи PandaDoc.

11. После завершения аутентификации вернитесь в окно VS Code, и вы готовы начать работу с запросами в VS Code.

Gemini (на базе Gemini CLI)

Чтобы настроить MCP-сервер PandaDoc для использования с Gemini:

1. Откройте терминал и перейдите в папку, где вы хотите работать.

2. Выполните следующую команду: gemini extensions install https://github.com/PandaDoc/mcp-server-guide

3. Нажмите Enter, чтобы начать процесс.

Инструкции различаются в зависимости от клиента. Для других клиентов спросите своего клиента, как добавить MCP-сервер, или обратитесь к документации вашего клиента.

Поддержка и конфиденциальность

• За помощью обратитесь в Центр поддержки PandaDoc.

• Ознакомьтесь с Уведомлением о конфиденциальности PandaDoc.

Лицензия

MIT