Account and organization 8 Tempo mínimo de leitura

Usando PaperOffice com Claude, ChatGPT, Grok e Cursor (MCP): o guia completo

O que o conector faz

O MCP (Model Context Protocol) é um padrão aberto por meio do qual um assistente de IA utiliza as ferramentas de outro sistema. O PaperOffice fornece um servidor MCP remoto para isso. Uma vez conectado, um assistente como o Claude pode trabalhar com os documentos nos espaços de trabalho do PaperOffice: pesquisar, ler, resumir, extrair dados, carregar, renomear, mover, solicitar assinaturas e iniciar fluxos de trabalho, sempre com as permissões do PaperOffice.

Não há nada para instalar. O assistente conecta-se a uma URL, faz o login com sua conta do PaperOffice e as ferramentas do PaperOffice aparecem dentro do chat.

Assistentes compatíveis e URLs do conector

  • Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, login com OAuth 2.1.
  • ChatGPT: https://mcp.paperoffice.ai/chatgpt, login com OAuth 2.1.
  • Grok: https://mcp.paperoffice.ai/grok, login com OAuth 2.1.
  • Cursor: https://mcp.paperoffice.ai/cursor, com um token de usuário pessoal ou um token de grupo.

Os perfis apontam para o mesmo servidor e diferem apenas no escopo das ferramentas.

O que você precisa

  • Uma conta do PaperOffice com pelo menos um espaço de trabalho.
  • Credits na conta. As chamadas de ferramentas são cobradas como chamadas de API.
  • Um plano de assistente que permita conectores, por exemplo, Claude Pro, Max, Team ou Enterprise. Nos planos Team e Enterprise, um administrador pode precisar habilitar o conector primeiro.

Conectar o Claude

  1. No claude.ai, abra Configurações → Connectors.
  2. Escolha Adicionar conector personalizado, insira o nome PaperOffice e a URL https://mcp.paperoffice.ai/claude. Deixe o ID do cliente e o segredo vazios; o login OAuth começa automaticamente.
  3. Escolha Conectar e faça o login com sua conta do PaperOffice. Revise o acesso solicitado e confirme.
  4. No chat, habilite as ferramentas do PaperOffice para a conversa.

O Claude Desktop usa a mesma lista de conectores que o claude.ai. No Claude Code, adicione o servidor com claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude e conclua o login com /mcp.

Um primeiro teste: pergunte “Quais espaços de trabalho do PaperOffice posso acessar?” O Claude deve listar seus espaços de trabalho.

Conectar o ChatGPT e o Grok

ChatGPT: abra Configurações → Connectors, adicione um conector personalizado com o nome PaperOffice, a URL https://mcp.paperoffice.ai/chatgpt e OAuth como autenticação, em seguida conecte e faça login. Dependendo do seu plano, o modo de desenvolvedor pode precisar ser ativado para conectores personalizados. O perfil ChatGPT é uma seleção curada de ferramentas; ele não contém, por exemplo, ferramentas de assinatura ou de fluxo de trabalho.

Grok: abra grok.com/connectors, crie um conector personalizado com a URL https://mcp.paperoffice.ai/grok e faça login com sua conta PaperOffice na primeira conexão. O perfil Grok também é uma seleção curada de ferramentas.

Conectar o Cursor com um token

  1. Faça o login no aplicativo do PaperOffice e abra Conta → API.
  2. Crie um token de usuário ou utilize um token de grupo fornecido pelo seu administrador. Você pode visualizar e copiar o token na página da API a qualquer momento; mantenha-o em local seguro.
  3. Adicione o servidor ao arquivo mcp.json do Cursor com a URL https://mcp.paperoffice.ai/cursor e o token como um token Bearer no cabeçalho de Autorização.
  4. Reinicie o Cursor ou recarregue os servidores MCP.

Nunca faça commit de um arquivo mcp.json com um token real em um repositório. As chaves secretas e as chaves publicáveis da API REST estão bloqueadas para o MCP.

Permissões: o assistente nunca obtém mais do que você

O assistente trabalha com as permissões do usuário PaperOffice conectado. A participação em espaços de trabalho, os papéis, as pastas compartilhadas, as regras de retenção (WORM) e as retenções legais continuam valendo sem alterações. Um usuário somente leitura em PaperOffice permanece somente leitura no assistente.

Cada ferramenta possui um título e indica se apenas lê ou altera algo. O assistente utiliza essas indicações para perguntar antes de agir. Excluir, esvaziar a lixeira e enviar solicitações de assinatura são marcados como destrutivos, portanto, espere uma pergunta de confirmação. Os documentos excluídos vão primeiro para a lixeira PaperOffice e podem ser restaurados no aplicativo.

As configurações da conta, faturamento, gerenciamento de usuários e a criação de chaves de API não estão disponíveis por meio do conector. Elas permanecem no aplicativo PaperOffice.

Fluxo de dados: o que o assistente vê e o que PaperOffice recebe

  1. Você escreve uma solicitação no assistente.
  2. O assistente decide qual ferramenta PaperOffice chamar e envia os parâmetros, por exemplo, um termo de pesquisa ou um ID de documento, para o servidor MCP PaperOffice.
  3. PaperOffice executa a chamada com suas permissões e retorna o resultado, por exemplo, o texto de um documento ou uma lista de nomes de arquivos.
  4. O resultado torna-se parte da sua conversa com o assistente e é tratado sob os termos do provedor do assistente.

PaperOffice não recebe seu histórico de chat, seus prompts ou as respostas do assistente. Apenas a própria chamada da ferramenta atinge o servidor: nome da ferramenta, parâmetros, horário e usuário. PaperOffice não carrega documentos para o provedor do assistente por conta própria; o provedor recebe apenas o que o assistente solicitou.

Cada chamada de ferramenta é registrada com horário, usuário e Credits. Os administradores veem as chamadas em API e Desenvolvedor → Uso da API.

Faturamento

Cada chamada de ferramenta por meio do conector é cobrada em Credits, exatamente como a chamada de API correspondente. Não há assinatura separada para o conector. Algumas consultas de status e saúde não são cobradas; os detalhes estão na documentação da API. Quando os Credits acabam, as chamadas são rejeitadas com uma mensagem clara; nada é excluído. Mais no guia sobre faturamento e Credits: Faturamento e Credits em PaperOffice AI.

Revogar acesso

  1. No assistente, remova ou desconecte o conector PaperOffice. O assistente para de usá-lo imediatamente; as conversas que já contêm resultados de PaperOffice mantêm esse texto.
  2. Em PaperOffice, abra Conta → API. As conexões do assistente aparecem na lista de tokens com um distintivo MCP. Exclua o token dessa conexão ali.
  3. Para Cursor, gire ou exclua o token na mesma página.

Revogar o acesso não exclui nenhum dado.

Solução de problemas

  • A janela de login não abre: permita pop-ups para o assistente e tente uma janela de navegação privada. Nos planos Team ou Enterprise, pergunte ao administrador se o conector está habilitado.
  • Conectado, mas nenhuma ferramenta PaperOffice aparece: habilite as ferramentas para a conversa ou inicie uma nova conversa.
  • "Não autorizado" durante uma chamada de ferramenta: a conexão foi revogada ou expirou. Conecte-se novamente. Com um token, verifique se é um token de usuário ou grupo.
  • O assistente não encontra documentos: solicite a lista de espaços de trabalho primeiro. O usuário conectado pode não ter acesso ao espaço de trabalho que você espera. Documentos carregados recentemente precisam de um momento até que o processamento seja concluído.
  • Não há Credits suficientes: recarregue no aplicativo PaperOffice ou habilite a recarga automática.

Ainda travado? Abra um ticket de suporte com o assistente e o plano, a mensagem exata, o horário com fuso horário e, se possível, uma captura de tela sem dados pessoais.

Recomendação para equipes de TI

  • Domínios para permitir: mcp.paperoffice.ai, api.paperoffice.ai e app.paperoffice.ai. Todo o tráfego usa HTTPS; nenhuma conexão de entrada à sua rede é necessária.
  • Comece com um piloto: um espaço de trabalho e papéis somente leitura. Habilite papéis de gravação por espaço de trabalho após o piloto.
  • Revise o uso da API regularmente durante as primeiras semanas.

Perguntas frequentes

  • É necessário instalar algo? Não. O assistente conecta-se a uma URL.
  • O assistente pode ver todos os meus documentos? Apenas o que o usuário PaperOffice tem permissão para ver.
  • A PaperOffice lê as minhas conversas? Não. Apenas as chamadas de ferramentas são enviadas para a PaperOffice.
  • Existe uma assinatura separada para o conector? Não. As chamadas são faturadas em Credits da mesma forma que as chamadas de API.
  • Como encerrar o acesso? Remova o conector no assistente e exclua o token da conexão em Conta → API.