# Conecte sua IA ao ProcStudio (MCP)

> O ProcStudio fala MCP, o protocolo aberto dos assistentes de IA. Ligue o Claude ou outro cliente compatível à sua conta e cadastre clientes, crie tarefas e trabalhos, gere documentos e atenda clientes direto da conversa — com as permissões do seu usuário.

Página: https://procstudio.com.br/mcp  
Guia completo no blog: https://procstudio.com.br/blog/o-que-e-mcp  
Conectar (área logada): https://procstudio.com.br/conectar-ia

## O que é

O ProcStudio publica um servidor MCP (Model Context Protocol), o padrão aberto que os assistentes de IA usam para descobrir e executar ações em sistemas externos. Conectado, o seu assistente consulta, cadastra e organiza dentro do seu escritório, em português, com a identidade e as permissões do seu usuário.

Hoje são 104 ações em 5 módulos. Cada ação usa o mesmo endpoint, as mesmas validações, o mesmo escopo de escritório e o mesmo registro de auditoria da tela.

## Módulos

### Atendimento ao cliente (4 ações)

Somente leitura: atendimento ao cliente final com o que o portal mostra

- Descobrir quem está falando pelo telefone (cliente ou representante)
- Listar os trabalhos que o cliente vê no portal
- Contar o andamento publicado no portal — e só ele
- Abrir o trabalho como o cliente o vê (equipe, poderes, documentos)

### Clientes (39 ações)

Cadastro, representação, anexos, OCR e documentos DOCX

- Cadastrar pessoa física — capaz, relativamente incapaz ou absolutamente incapaz
- Cadastrar pessoa jurídica com sócio ou administrador
- Vincular representante, curador, tutor ou procurador
- Buscar cliente por nome, CPF ou CNPJ
- Editar cadastro, endereço, telefone e conta bancária
- Enviar o link de acesso ao portal do cliente
- Arquivar e restaurar cliente
- Anexar documentos por link temporário
- Extrair dados de identidade, comprovante e contrato social
- Gerar procuração simples em DOCX
- Gerar declaração de residência por terceiro

### Tarefas (15 ações)

Prazos, responsáveis, status e comentários

- Criar tarefa com prazo, prioridade e responsável
- Abrir a tarefa pelo número que aparece na tela
- Listar o que vence hoje, esta semana ou está atrasado
- Mudar status, prazo e equipe da tarefa
- Comentar mencionando alguém do escritório
- Arquivar e restaurar tarefa

### Equipe (4 ações)

Somente leitura: integrantes, escritórios e saldo de IA

- Ver quem trabalha no escritório, com papel e OAB
- Descobrir a quem atribuir uma tarefa, pelo nome
- Saber a que escritório cada pessoa pertence
- Listar os escritórios do time
- Consultar saldo de IA compartilhado pelo time

### Trabalhos (42 ações)

Criação, convites, procedimentos, honorários contratuais e documentos DOCX

- Criar trabalho para cliente cadastrado ou por convite
- Preparar e retomar rascunhos a partir de modelos
- Definir poderes, honorários contratuais e responsável inicial
- Calcular parcelas com entrada e vencimentos
- Buscar trabalhos e consultar seus procedimentos
- Criar procedimentos e procedimentos filhos
- Registrar movimentações e tarefas vinculadas
- Gerar e baixar documentos DOCX
- Renovar somente a data de um documento com histórico preservado

### Em breve

- Intimações: Publicações do DJEN e contagem de prazo

## Clientes compatíveis

- **Claude Code** — Um comando no terminal (`claude mcp add`), copiado pronto da tela Conectar IA com a sua chave já dentro.
- **Claude Desktop** — Um bloco de configuração em JSON, também copiado pronto, colado nas integrações do aplicativo.
- **Outros clientes MCP** — Qualquer assistente que fale MCP por HTTP (JSON-RPC 2.0) e aceite um cabeçalho de autorização. A tela mostra endereço, transporte e cabeçalho.

## Como conectar

1. **Entre na sua conta e abra Conectar IA.** A página fica no menu do sistema. Ela mostra quantas ações estão disponíveis e quantas chaves o seu escritório já tem ativas.
2. **Gere a sua chave pessoal.** Dê um nome à chave (por exemplo, "Claude no meu notebook") e gere. Ela aparece uma única vez: guarde na hora. Cada pessoa do escritório gera a sua, porque a IA assina cada ação com o nome de quem criou a chave.
3. **Escolha o modo e copie a configuração.** Clássico entrega todas as ações de uma vez; Compacto faz a IA buscar a ação certa conforme a tarefa, gastando menos contexto no começo. Os dois usam a mesma chave e as mesmas permissões. Copie o comando (Claude Code), o JSON (Claude Desktop) ou os dados de conexão (outro cliente).
4. **Confirme com uma pergunta que só o seu escritório responde.** "Quantos clientes eu tenho cadastrados, e quantas tarefas vencem esta semana?" Se vier número, está conectado.

## Segurança e privacidade

- **Chave por pessoa, não por escritório.** Cada usuário gera a própria chave. A IA se apresenta como quem a gerou e cada ação fica registrada com esse nome — dividir a chave faz o trabalho da equipe inteira aparecer no histórico de uma pessoa só.
- **Mesmas permissões da tela.** A IA age pelos mesmos caminhos, validações, escopo de escritório e registro de auditoria que valem para você no navegador. O que o seu usuário não pode fazer, a sua IA também não pode. Não existe porta dos fundos.
- **A chave abre só a camada MCP.** Ela não dá acesso à API do sistema nem a nenhum outro endereço. Pode ser revogada a qualquer momento na tela de Equipe, e revogar invalida na hora os links temporários emitidos por ela.
- **Ações sensíveis pedem confirmação.** Operações que custam saldo (como OCR de documentos) ou publicam algo para o cliente exigem confirmação explícita sua antes de executar.
- **O que a IA nunca vê.** Exclusão permanente, anonimização, dados bancários de sócios, custas, pagamentos e assinatura eletrônica não existem para a IA — nem com confirmação. No atendimento ao cliente final, ela enxerga apenas o que o portal do cliente já mostra.
- **Os dados ficam com o assistente que você escolheu.** O ProcStudio responde ao seu cliente de IA e não envia nada por conta própria. O que a IA lê passa pelo assistente e pelo provedor que você contratou, sob os termos deles. A anonimização com ZDR descrita em /ia-zdr vale para os recursos de IA do próprio ProcStudio.

## Limites

- Custas, parcerias, assinaturas, pagamentos e demais operações financeiras continuam na tela do Trabalho.
- Edição posterior de equipe e honorários de um Trabalho existente fica em Equipe & Finanças, pela tela.
- Anexar arquivo direto na conversa não é possível pelo protocolo. Documentos de clientes entram por um link temporário de envio, fora da conversa, ou pela tela.
- OCR de identidade, comprovante e contrato social consome saldo de IA do escritório e pede confirmação a cada execução.
- Gerar um documento DOCX não o assina nem o envia; o arquivo é baixado por um link que expira em 15 minutos.
- O catálogo cresce por módulo. Intimações ainda não responde pela IA.

## Perguntas frequentes

### O que é MCP?

Model Context Protocol é um padrão aberto que define como um assistente de IA descobre e usa as ferramentas de um sistema externo. O ProcStudio publica um servidor MCP: o seu assistente lê a lista de ações disponíveis, pergunta o que precisa e executa, sempre com a sua identidade.

### Qual assistente de IA posso usar?

Claude Code e Claude Desktop têm configuração pronta para copiar. Qualquer outro cliente que fale MCP por HTTP com cabeçalho de autorização também conecta — a tela Conectar IA mostra os dados necessários.

### A IA passa a ver tudo do escritório?

Não. Ela vê e faz exatamente o que o seu usuário vê e faz pela tela, dentro do seu escritório. Dados financeiros de sócios, exclusões permanentes, assinatura e pagamentos ficam de fora por decisão de produto.

### Preciso de uma chave por pessoa?

Sim. A chave identifica quem está agindo e assina cada ação no histórico. Uma chave compartilhada mistura o trabalho de todos no nome de uma pessoa só.

### Posso revogar o acesso?

Sim, a qualquer momento, na tela de Equipe do ProcStudio. A chave deixa de valer na hora, inclusive para links temporários de download já emitidos.

### Usar a IA conectada custa alguma coisa?

A conexão em si não consome saldo de IA do ProcStudio: a busca de ações, as consultas e os cadastros usam a sua conta normalmente. O que custa saldo são as operações que já custam na tela, como OCR de documentos, e elas pedem confirmação antes. O uso do assistente é cobrado pelo provedor que você contratou.

### Qual a diferença entre os modos Clássico e Compacto?

O Clássico entrega todas as ações ao conectar. O Compacto publica quatro operações de descoberta e a IA busca o contrato de cada ação conforme a tarefa, gastando menos contexto no início da conversa. Permissões, validações, confirmações e auditoria são idênticas nos dois.

## Saiba mais

- Inteligência artificial no ProcStudio: https://procstudio.com.br/ia
- Proteção de dados e ZDR: https://procstudio.com.br/ia-zdr
- IA Conectada (recurso): https://procstudio.com.br/recursos/ia-conectada
- Todos os recursos: https://procstudio.com.br/recursos