DocSpring

npx add-mcp 'https://mcp.docspring.com/mcp'

Abrir no Claude Abrir no ChatGPT

O servidor MCP do DocSpring permite que um assistente de IA trabalhe na sua conta do DocSpring. Ele pode encontrar seus modelos, preenchê-los e gerar PDFs e documentos do Word, criar designs de página, editar campos e publicar versões, configurar solicitações de assinatura e gerenciar pastas, webhooks e ações de e-mail. É um servidor remoto que usa o Model Context Protocol: você adiciona a URL ao seu assistente e entra no DocSpring. Não há token de API para copiar.

Região	URL do servidor MCP
EUA	https://mcp.docspring.com/mcp
UE	https://mcp-eu.docspring.com/mcp

Use a URL da região em que sua conta está. Se você entra no DocSpring em app-eu.docspring.com, sua conta está na UE. Os exemplos abaixo usam a URL dos EUA. Para a UE, use a URL correspondente nos comandos e arquivos de configuração e nomeie o servidor como docspring-eu, como faz o plugin do DocSpring, para que ele não substitua um servidor dos EUA chamado docspring.

Para agentes de programação (Claude Code, Codex, Copilot, Gemini CLI), o plugin do DocSpring adiciona o servidor MCP junto com as habilidades de agente do DocSpring, que ensinam ao agente os fluxos de trabalho do DocSpring.

Conecte seu assistente

Adicione a URL ao seu assistente, depois entre no DocSpring pelo navegador e escolha o que o assistente pode fazer (consulte Acesso).

Ainda não tem uma conta do DocSpring? Crie uma na página de login que seu assistente abrir, usando Google, GitHub ou seu e-mail, e conecte-se por lá. Depois, peça ao assistente para criar seu primeiro modelo.

Claude

Claude.ai, Claude Desktop e os aplicativos móveis do Claude compartilham os mesmos conectores. Estes botões abrem a caixa de diálogo “Adicionar conector personalizado” do Claude com a URL do DocSpring preenchida:

Para adicioná-lo manualmente, acesse Personalizar > Conectores, clique em + Adicionar e depois em Adicionar conector personalizado. Digite DocSpring como nome e a URL do servidor MCP, depois clique em Adicionar e entre. Em um chat, ative o DocSpring no menu +, em Conectores.

Os conectores personalizados funcionam em todos os planos do Claude (o plano Free permite um). Nos planos Team e Enterprise, um proprietário adiciona o conector em Configurações da organização > Conectores; depois, cada membro o conecta em Personalizar > Conectores.

Claude Code

claude mcp add --transport http --scope user docspring https://mcp.docspring.com/mcp

Em seguida, execute /mcp no Claude Code, selecione docspring e entre. --scope user adiciona o servidor a todos os seus projetos. Se você entrou no Claude Code com uma assinatura do Claude, um conector do DocSpring que você adicionou no Claude já estará disponível.

ChatGPT

Para adicionar um servidor MCP ao ChatGPT, é necessário ter um espaço de trabalho Business, Enterprise ou Edu, e isso só funciona na web. Em um espaço de trabalho Business, um administrador ou proprietário o adiciona. O ChatGPT Pro pode adicioná-lo com ferramentas somente de leitura.

1. Abra Plugins, clique em + e depois em Adicionar servidor MCP personalizado.
2. Digite DocSpring como nome, a URL do servidor MCP como conexão e escolha OAuth para autenticação.
3. Confirme, clique em Criar como plugin e entre no DocSpring.

Em um chat, digite @ e escolha DocSpring.

Codex

codex mcp add docspring --url https://mcp.docspring.com/mcp
codex mcp login docspring

A CLI do Codex, sua extensão para IDE e o aplicativo para desktop do ChatGPT compartilham essa configuração.

Cursor

Ou adicione o servidor a ~/.cursor/mcp.json (todos os projetos) ou a .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "docspring": { "url": "https://mcp.docspring.com/mcp" }
  }
}

O Cursor solicitará que você entre depois de adicionar o servidor.

VS Code

Ou execute MCP: Add Server na Paleta de Comandos e escolha HTTP, ou adicione o servidor a .vscode/mcp.json:

{
  "servers": {
    "docspring": { "type": "http", "url": "https://mcp.docspring.com/mcp" }
  }
}

Na primeira conexão, o VS Code abrirá seu navegador para você entrar.

Outros assistentes

Qualquer cliente MCP compatível com servidores remotos (Streamable HTTP) e login OAuth pode se conectar: Gemini CLI, Zed, Goose e outros. Adicione a URL do servidor MCP como servidor remoto ou HTTP, e o cliente abrirá a página de login do DocSpring na primeira conexão. Por exemplo, no Gemini CLI:

gemini mcp add --scope user --transport http docspring https://mcp.docspring.com/mcp

Acesso

Ao entrar, o DocSpring pede que você escolha o que o assistente pode fazer. Leitura e gravação fica selecionado até você escolher outra opção:

Acesso	O que o assistente pode fazer
Somente leitura	Ver seus modelos, pastas, envios e os PDFs correspondentes, suas ações de e-mail e domínios de e-mail, além de verificar dados em relação a um modelo
Leitura e gravação	Também criar e editar modelos e seus campos, publicar versões, gerar PDFs, criar solicitações de assinatura e adicionar e verificar domínios de e-mail
Acesso total	Também excluir modelos, versões, pastas e domínios de e-mail, expirar envios, criar webhooks que enviam seus envios e outros eventos para uma URL e criar ações de e-mail que enviam seus PDFs por e-mail

Se um assistente solicitar menos que acesso total ao entrar, o DocSpring mostrará o que ele solicitou, e você poderá conectá-lo com esse nível de acesso ou cancelar.

O assistente só vê as ferramentas permitidas pelo nível de acesso. Ferramentas do servidor MCP lista essas ferramentas.

Cada assistente conectado aparece em Aplicativos conectados, na página Integrações do DocSpring. Qualquer pessoa da conta pode desconectá-lo nessa página, e o acesso é interrompido imediatamente. Para alterar o acesso de um assistente, desconecte-o e entre novamente.

PDFs de produção usam os créditos da sua conta, assim como acontece pela API. PDFs de teste são gratuitos e têm marca d’água, e as ferramentas pedem ao assistente que gere PDFs de teste, a menos que você solicite um documento real. A configuração automática dos campos de um novo modelo usa primeiro as páginas de IA gratuitas da sua conta para o mês e, depois, créditos, assim como no editor de modelos.

Exemplos de prompts

Em um assistente de chat:

• “Crie um modelo de certificado de conclusão com o nome do destinatário, o curso e a data.”
• “Liste meus modelos do DocSpring e mostre os campos do contrato de aluguel.”
• “Crie um modelo a partir de https://example.com/form.pdf, configure os campos e depois me mostre a primeira página.”
• “Crie uma fatura de uma página como design de página, com uma tabela de itens e o total, e depois me mostre uma prévia.”
• “Gere um PDF de teste do modelo de fatura para a Acme Corp, com três itens à sua escolha.”
• “Renomeie o campo name no modelo de contrato para full_name e publique uma nova versão.”
• “Envie o modelo de NDA para Jane e depois para Sam assinarem, nessa ordem, com um lembrete a cada 3 dias.”
• “Mova todos os modelos com ‘Rascunho’ no nome para uma nova pasta chamada Rascunhos.”

Em um agente de programação, trabalhando no repositório do seu aplicativo:

• “Crie um modelo do DocSpring a partir de forms/application.pdf, configure os campos e gere tipos TypeScript para os dados.”
• “Escreva o código que preenche nosso modelo de integração a partir de um registro de cliente usando o SDK do DocSpring e depois gere um PDF de teste para verificá-lo.”
• “Gere um PDF de teste do modelo de contrato de locação para cada cliente em fixtures/customers.csv.”

Assistentes que oferecem os prompts de um servidor MCP como comandos também têm Criar um modelo, que cria um novo modelo com você, a partir de uma descrição ou do seu PDF. Essa opção fica disponível quando o assistente tem acesso de gravação. No Claude Code, digite / e procure create_template: para um servidor adicionado como docspring, é /mcp__docspring__create_template.

Segurança

• Um assistente com acesso pode ler os dados dos seus envios, que podem incluir dados pessoais. Conecte apenas assistentes que sua organização autoriza a lidar com esses dados.
• O texto lido por um assistente, como um PDF da web ou os dados de um envio, pode conter instruções destinadas a fazê-lo usar suas ferramentas de forma indevida. A maioria dos assistentes pede confirmação antes de chamar uma ferramenta que altera algo, e as ferramentas que alteram ou removem o que já existe (editar um modelo ou seus campos, renomear, mover, restaurar uma versão, alterar um webhook ou uma ação de e-mail, excluir, expirar) são marcadas como destrutivas, então os clientes pedem sua confirmação para cada chamada. Escolha Somente leitura quando o assistente só precisar consultar informações.
• Com acesso total, um assistente gerencia seus webhooks, que enviam os dados dos seus envios para uma URL, e suas ações de e-mail, que enviam seus PDFs por e-mail. Ele pode alterar todos eles, inclusive os que você mesmo configurou, e o que ele configurar continuará funcionando depois que você o desconectar. Escolha Leitura e gravação quando ele não precisar gerenciá-los.
• Os assistentes nunca veem o segredo de assinatura de um webhook nem os valores dos cabeçalhos: copie o segredo na página do webhook no DocSpring (Webhooks na barra lateral) e adicione os cabeçalhos nessa página.

Solução de problemas

O assistente não tem as ferramentas do DocSpring. Adicionar o servidor não basta: você também precisa entrar. No Claude, clique em Conectar ao lado do DocSpring em Personalizar > Conectores e ative-o para o chat no menu +. No Claude Code, execute /mcp e selecione docspring (docspring-eu para a UE). No Codex, execute codex mcp login docspring (ou docspring-eu).

O login não reconhece sua conta ou seus modelos não aparecem. Você se conectou ao servidor da outra região. Se você entra em app-eu.docspring.com, conecte https://mcp-eu.docspring.com/mcp e dê a ele o nome docspring-eu; caso contrário, use https://mcp.docspring.com/mcp.

Uma ferramenta que você esperava não aparece. O assistente só tem as ferramentas permitidas pelo nível de acesso: Somente leitura não inclui ferramentas que alteram algo. Para alterar o acesso, desconecte o assistente em Aplicativos conectados, na página Integrações, e entre novamente. O ChatGPT Pro só recebe as ferramentas de leitura, independentemente da opção escolhida.

As novas ferramentas não aparecem. Alguns assistentes mantêm a lista de ferramentas que viram quando você se conectou. Reconecte o DocSpring ou atualize-o nas configurações de conectores do assistente.

O assistente foi desconectado. Isso acontece quando alguém da sua conta o desconecta no DocSpring ou quando ele não é usado por 90 dias. Entre novamente pelo assistente: no Claude, clique em Reconectar ao lado do DocSpring em Personalizar > Conectores.

Uma ferramenta retornou processing. O PDF ou modelo levou mais de cerca de 50 segundos. Peça ao assistente para verificar novamente: ele usa get_submission ou get_template.

A geração de PDFs de produção falha com um erro de créditos. PDFs de produção usam os créditos da sua conta. Adicione créditos na página Faturamento. Se o erro disser que o PDF será processado quando você adicionar créditos, ele será gerado nesse momento; portanto, não peça novamente. PDFs de teste são gratuitos enquanto você experimenta, mas combinar PDFs sempre usa créditos.

Se precisar de mais ajuda: envie um e-mail para [email protected] ou use o formulário de contato.

Ferramentas do servidor MCP Todas as ferramentas e o acesso necessário para usá-las