# mcp-server

Интегрирует API SignDocs Brasil для отправки документов на подпись, проверки отметок ICP-Brasil и отслеживания статусов прямо через диалог с ИИ.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: signdocsbrasil
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/signdocsbrasil/signdocs-mcp-server
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/mcp/signdocsbrasil-mcp-server

## Что делает

Сервер связывает ИИ-агента с бразильским сервисом электронного документооборота SignDocs Brasil. Через него ассистент создаёт сессии подписания, формирует конверты для нескольких участников, запрашивает повторную отправку OTP и получает готовые PDF со штампами. Для аудита доступны инструменты проверки криптографических свидетельств и валидации подписей в файлах.

Внутри работает адаптер поверх официального пакета `@signdocs-brasil/api`, который берёт на себя обмен OAuth2-токенов, кэширование и повторные попытки при ошибках. Поддерживается локальный запуск через `stdio` и удалённое подключение по HTTP к `https://mcp.signdocs.com.br/mcp`.

Для старта требуются переменные `SIGNDOCS_CLIENT_ID` и `SIGNDOCS_CLIENT_SECRET` из личного кабинета. Режим `SIGNDOCS_ENVIRONMENT=production` списывает платную квоту и создаёт юридически значимые подписи, поэтому тестировать логику безопаснее на стенде `hml`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.signdocs.com.br/mcp`
- Переменные окружения: `SIGNDOCS_CLIENT_ID`, `SIGNDOCS_CLIENT_SECRET`, `SIGNDOCS_ENVIRONMENT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp-server https://mcp.signdocs.com.br/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> --env SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> --env SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> --transport stdio signdocsbrasil-mcp-server -- npx -y @signdocs-brasil/mcp-server
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add signdocsbrasil-mcp-server --url https://mcp.signdocs.com.br/mcp
```

2. **Командой платформы**
```bash
codex mcp add signdocsbrasil-mcp-server --env SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> --env SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> --env SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> -- npx -y @signdocs-brasil/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "signdocsbrasil-mcp-server": {
            "url": "https://mcp.signdocs.com.br/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "signdocsbrasil-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@signdocs-brasil/mcp-server"
            ],
            "env": {
                "SIGNDOCS_CLIENT_ID": "<SIGNDOCS_CLIENT_ID>",
                "SIGNDOCS_CLIENT_SECRET": "<SIGNDOCS_CLIENT_SECRET>",
                "SIGNDOCS_ENVIRONMENT": "<SIGNDOCS_ENVIRONMENT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "signdocsbrasil-mcp-server": {
            "type": "http",
            "url": "https://mcp.signdocs.com.br/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "signdocsbrasil-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@signdocs-brasil/mcp-server"
            ],
            "env": {
                "SIGNDOCS_CLIENT_ID": "<SIGNDOCS_CLIENT_ID>",
                "SIGNDOCS_CLIENT_SECRET": "<SIGNDOCS_CLIENT_SECRET>",
                "SIGNDOCS_ENVIRONMENT": "<SIGNDOCS_ENVIRONMENT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http signdocsbrasil-mcp-server https://mcp.signdocs.com.br/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e SIGNDOCS_CLIENT_ID=<SIGNDOCS_CLIENT_ID> -e SIGNDOCS_CLIENT_SECRET=<SIGNDOCS_CLIENT_SECRET> -e SIGNDOCS_ENVIRONMENT=<SIGNDOCS_ENVIRONMENT> signdocsbrasil-mcp-server npx -y @signdocs-brasil/mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- подготовить конверт документов для группы подписантов
- выпустить ссылку на электронное подписание договора
- проверить действительность сертификатов и отметок ICP-Brasil в PDF
- настроить вебхуки для уведомлений об изменении статуса сделки

## Примеры запросов агенту
- Создай сессию подписания для контракта и пришли готовую ссылку signingUrl
- Добавь второго участника в конверт с документами
- Проверь электронные подписи в загруженном файле акта

## Похожие
- [Excel MCP Server](https://affpapa.org/nevibecode/mcp/excel-mcp-server.md) — MCP-сервер · ★ 4268
- [kordoc](https://affpapa.org/nevibecode/mcp/kordoc.md) — MCP-сервер · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP-сервер · ★ 1085
- [anymd](https://affpapa.org/nevibecode/mcp/anymd.md) — MCP-сервер · ★ 1054
- [Docling MCP](https://affpapa.org/nevibecode/mcp/docling-mcp.md) — MCP-сервер · ★ 779

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md