Todos os temas
Português

Conexões de IA (MCP) · 20 min de leitura

Conexões de IA (MCP): configuração, autenticação e uso

Guia completo do MCP do CRMDAY One: módulos, configuração, OAuth com PKCE, permissões, exemplos de uso, segurança e solução de problemas.

Neste guia
  1. 1. O que é MCP e para que serve
  2. 2. O que está disponível em cada módulo
  3. 3. Como funcionam organização, aplicativo e autorização
  4. 4. Antes de começar
  5. 5. Habilitar MCP na organização
  6. 6. Conectar um aplicativo pelo cadastro manual
  7. 7. Aplicativo público e registro dinâmico
  8. 8. Escopos: selecionar exatamente o acesso necessário
  9. 9. OAuth, tokens e validade da autorização
  10. 10. Primeiros testes e exemplos de uso
  11. 11. Criar, editar e mover registros com segurança
  12. 12. Social: imagens, rascunhos e agendamento
  13. 13. Conversas: consulta e análise de histórico
  14. 14. Ampliar acesso, reconectar ou revogar
  15. 15. Solução de problemas
  16. 16. Referência técnica para integrações
  17. 17. Catálogo de ferramentas
  18. 18. Privacidade e rotina de administração

Este guia explica como conectar um aplicativo de inteligência artificial ao CRMDAY One com segurança: o que o MCP oferece, como habilitar a organização, cadastrar um aplicativo, autorizar o acesso, usar os módulos e encerrar a conexão. Destina-se a administradores, usuários autorizados e equipes de integração.

Endereço de conexão: https://one.crmday.net/mcp. Este endereço recebe conexões de aplicativos; a documentação pública é esta página. Revisão do conteúdo: 7 de novembro de 2026. A disponibilidade real depende dos recursos da organização, das permissões do usuário e dos escopos autorizados.

1. O que é MCP e para que serve

MCP significa Model Context Protocol. É um protocolo que permite que um aplicativo de IA descubra e execute ferramentas oferecidas por um sistema. No CRMDAY One, essas ferramentas permitem pesquisar informações e realizar operações delimitadas em nome de um usuário que autorizou a conexão.

Por exemplo: consultar contatos sem apólice visível, criar uma tarefa vinculada a um cliente, mover uma oportunidade de etapa, analisar mensagens de atendimento de um período ou preparar e agendar conteúdo do Social. O aplicativo interpreta o pedido e chama as ferramentas disponíveis; o CRMDAY valida cada operação e devolve o resultado.

O servidor MCP não fornece, por si só, um modelo de IA ou uma assinatura do aplicativo escolhido. O processamento dos dados pela IA segue as condições e configurações desse aplicativo. Habilitar o MCP externo também não amplia automaticamente os recursos do assistente interno do CRMDAY One.

2. O que está disponível em cada módulo

MóduloOperações oferecidasLimites relevantes
ContatosPesquisar, consultar um registro, criar e editar nome, e-mail e telefone.Respeita visibilidade de registros e campos. Não oferece exclusão, troca de responsável ou edição arbitrária de campos personalizados.
Apólices (Policies)Pesquisar, consultar, criar e editar campos delimitados, incluindo número, linha/subtipo, situação, seguradora/plano, datas e contato; pesquisar produtores habilitados.A criação exige um produtor licenciado disponível na organização. Não é uma ferramenta para emitir seguro na seguradora ou executar uma cotação ACA.
DealsPesquisar, consultar, criar e editar oportunidades; consultar pipelines e etapas; mover para outra etapa do mesmo pipeline.Movimentações usam a versão atual do registro e podem disparar automações existentes. Não há transferência para pipeline arbitrário nem troca de responsável.
TasksPesquisar, consultar, criar e editar tarefas; consultar quadros e etapas; mover entre etapas do mesmo quadro.Preserva validações e lembretes do sistema. Não equivale a acesso completo a todas as funções de agenda.
ConversasEncontrar inboxes, pesquisar atendimentos, consultar metadados, ler mensagens de texto e preparar/ler exportações por inbox e período para análise.Exportação exige administrador/proprietário ou suporte global em contexto privilegiado. Não envia mensagens, altera responsável/situação, marca leitura nem baixa anexos.
SocialConsultar diretrizes da marca, perfis, campanhas e posts; importar imagens; criar/editar campanhas e posts editoriais; agendar um post aprovado.Agendamento exige escopo próprio e confirmação explícita. Posts agendados, publicados ou arquivados devem ser alterados pela interface Social.

Há também consulta do contexto da organização e pesquisa de relacionamentos entre Contatos, Apólices, Deals e Tasks. Um resultado “sem apólice” significa sem vínculo visível ao usuário, e não comprova ausência de registros aos quais ele não tem acesso.

O MCP não oferece administração completa do sistema. Não inclui ferramentas gerais para usuários, cobrança, comissões, assinaturas/documentos, e-mail, telefonia, exclusão de registros ou publicação imediata no Social. Os resumos não expõem SSN, renda, household, documentos, credenciais de provedores ou campos personalizados arbitrários. Texto livre de mensagens e registros ainda pode conter dados pessoais.

3. Como funcionam organização, aplicativo e autorização

Existem três controles complementares:

  1. Acesso da organização: um administrador habilita o MCP e define quais recursos poderão ser autorizados.
  2. Cadastro do aplicativo: identifica o cliente OAuth, seus callbacks e escopos possíveis. Um cadastro pendente ainda não tem acesso aos dados.
  3. Autorização do usuário: o usuário entra no CRMDAY e confirma organização, aplicativo e recursos. Essa autorização tem validade e pode ser revogada.

O acesso efetivo é a combinação desses limites com as permissões reais do usuário, o plano e os módulos disponíveis. Um escopo de escrita não transforma um usuário em administrador e não permite editar um registro oculto. A verificação acontece novamente em cada chamada.

O serviço é multi-organização: várias organizações usam o mesmo endereço público, mas cada autorização fica vinculada a uma organização. Conhecer um ID de outra organização não permite acessá-la. A organização não pode ser trocada nos argumentos de uma ferramenta. Para trabalhar em outra conta, faça o fluxo de conexão e consentimento correspondente.

4. Antes de começar

  • Tenha acesso ativo à organização correta no CRMDAY One e aos módulos que deseja usar.
  • Para habilitar e gerenciar aplicativos, use uma conta administradora da organização.
  • Escolha um aplicativo compatível com MCP por Streamable HTTP e OAuth Authorization Code com PKCE S256, cliente público sem segredo.
  • Para o cadastro manual, obtenha no aplicativo de IA o endereço exato de callback OAuth. Ele é fornecido pelo aplicativo, não deve ser inventado.
  • Defina previamente quais informações e operações o aplicativo precisa usar. Comece com leitura quando isso atender à finalidade.
  • Para Social, mantenha as conexões das redes e os perfis de destino operacionais. Para Conversas, o usuário precisa ter acesso às inboxes correspondentes.

Um cliente que aceite apenas API key fixa, segredo OAuth obrigatório, transporte stdio ou PKCE “plain” não atende a este fluxo. Recursos e nomes dos menus do aplicativo de IA podem variar conforme sua versão e plano.

5. Habilitar MCP na organização

  1. Entre no CRMDAY One e confira a organização ativa.
  2. Abra Configurações → Conexões de IA (MCP), disponível também em one.crmday.net/settings/mcp.
  3. Em Acesso da organização, habilite as conexões.
  4. Escolha os recursos permitidos e salve. Se o painel estiver recolhido, expanda-o para revisar a configuração.
  5. Confira se leitura, escrita, agendamento e exportação foram liberados somente conforme a necessidade da equipe.

Habilitar a organização não cria uma conexão, não concede consentimento e não aumenta os acessos de aplicativos existentes. O atalho Selecionar todos os recursos disponíveis seleciona apenas o que a organização permite; ainda é necessário salvar/cadastrar e autorizar.

6. Conectar um aplicativo pelo cadastro manual

  1. Na tela MCP, abra Conectar um aplicativo → Preparar aplicativo e escolha ChatGPT ou outro cliente.
  2. Copie o endereço MCP exibido. No ambiente público principal, ele é https://one.crmday.net/mcp.
  3. No aplicativo de IA, inicie o cadastro de uma conexão MCP remota com OAuth. Copie o callback exibido pelo próprio aplicativo antes de concluir.
  4. Volte ao CRMDAY. Em Definir acesso, informe um nome reconhecível, cole o callback exato e selecione os recursos. Podem ser cadastrados até cinco callbacks exatos; não use wildcard.
  5. Gere o identificador e avance para Concluir conexão. Copie o client_id e confira os escopos.
  6. No aplicativo, informe esse ID, selecione o método de autenticação do cliente none e deixe client_secret vazio. Solicite somente escopos cadastrados e mantenha PKCE S256 habilitado.
  7. Inicie a conexão. O navegador abrirá o CRMDAY para login e consentimento.
  8. Confira nome do aplicativo, organização, usuário, recursos e validade antes de aprovar. Se a organização estiver errada, ajuste o contexto e reinicie a autorização.
  9. Retorne ao aplicativo. No CRMDAY, use Verificar autorização ou Atualizar lista para confirmar que a conexão aparece em Conexões autorizadas.

Callbacks de produção devem usar HTTPS, sem fragmento ou credenciais na URL. Para desenvolvimento, o servidor aceita HTTP em IP de loopback permitido; não é autorização para usar callback HTTP público. O callback precisa coincidir literalmente com o cadastrado.

Em Aplicativos cadastrados → Dados para conectar, é possível recuperar ID e escopos. O estado “pendente de autorização” significa que o cadastro existe, mas o consentimento ainda não foi concluído. Use o nome CRMDAY One no aplicativo para facilitar a identificação; o nome/ícone definidos no cliente externo são administrados naquele cliente.

7. Aplicativo público e registro dinâmico

O CRMDAY One também suporta um cadastro OAuth público da plataforma, reutilizável entre organizações. Cada organização continua precisando habilitar o MCP e cada usuário continua precisando consentir. Um aplicativo público não concede acesso universal aos clientes do CRMDAY.

O Superadmin administra esse cadastro em Configurações → Plataforma → Aplicativo público CRMDAY One. O administrador de uma organização pode administrar o acesso local, mas não cria ou modifica a identidade global da plataforma.

O endpoint de registro dinâmico /api/mcp/oauth/register atende clientes públicos com callbacks permitidos do ChatGPT. Não é um serviço de cadastro automático aberto a qualquer domínio. Aceita os callbacks documentados https://chatgpt.com/connector/oauth/{id} e https://chatgpt.com/connector_platform_oauth_redirect, sem query, fragmento ou credenciais. Outros clientes usam o cadastro manual compatível.

O registro dinâmico não habilita organizações nem cria autorizações. Conversas exige solicitação explícita dos seus escopos: omitir scope no registro preserva os onze escopos anteriores, sem adicionar Conversas. A existência do servidor e do registro público não comprova aprovação ou disponibilidade em diretório de aplicativos de terceiros.

8. Escopos: selecionar exatamente o acesso necessário

EscopoPermissão solicitada
contacts:readPesquisar e consultar contatos.
contacts:writeCriar e editar contatos.
policies:readPesquisar e consultar apólices.
policies:writeCriar e editar apólices; consultar produtores para criação.
deals:readConsultar oportunidades, pipelines e etapas.
deals:writeCriar, editar e mover oportunidades.
tasks:readConsultar tarefas, quadros e etapas.
tasks:writeCriar, editar e mover tarefas.
social:readConsultar marca, perfis, campanhas e posts.
social:writeImportar imagens, criar e editar conteúdo editorial.
social:scheduleAgendar publicação de post aprovado.
conversations:readConsultar inboxes, conversas e mensagens acessíveis.
conversations:exportPreparar e ler histórico para análise, com papel administrativo.

Cada escopo :write exige o :read correspondente. social:schedule exige social:write e social:read; conversations:export exige conversations:read e papel autorizado.

Exemplos: uma conexão para consultar contatos usa contacts:read; uma para redigir conteúdo Social sem publicar usa social:read social:write; para agendamento, acrescente social:schedule. Para relacionar contatos e apólices, conceda leitura dos dois módulos.

9. OAuth, tokens e validade da autorização

OAuth permite autorizar o aplicativo sem entregar a ele sua senha do CRMDAY. O login acontece no CRMDAY; depois do consentimento, o aplicativo recebe um código temporário e o troca por tokens. PKCE vincula essa troca ao cliente que iniciou o fluxo. O aplicativo deve gerar e validar state para correlacionar o retorno.

  • Código de autorização: uso único, validade de cinco minutos.
  • Access token: usado nas chamadas, validade máxima de uma hora.
  • Refresh token: permite renovar o par de tokens durante a validade da autorização; gira a cada uso.
  • Autorização (grant): validade máxima de 30 dias; pode terminar antes por revogação, mudança de acesso ou fim do contexto privilegiado.

A renovação não estende o prazo final da autorização. O cliente precisa guardar o novo par de tokens e serializar renovações: a rotação invalida o access token anterior. Reutilizar um refresh token consumido, ou repetir um código consumido com PKCE válido, revoga a autorização inteira. Em caso de expiração definitiva, faça novo consentimento.

Continuar na mesma conversa de IA não prolonga o acesso. Para Superadmin, a autorização termina no máximo junto com o contexto privilegiado original; iniciar outro contexto não recupera uma autorização antiga. Acesso delegado/federado não pode conceder MCP.

Cookie de login, chave da API pública e ID da organização não autenticam chamadas MCP. O transporte usa exclusivamente Authorization: Bearer <access_token>. Não compartilhe tokens, códigos ou verificadores PKCE em chamados, mensagens ou documentos públicos.

10. Primeiros testes e exemplos de uso

Depois de conectar, peça ao aplicativo para consultar crmday_context e informar a organização e os recursos efetivos. Em seguida, atualize/consulte o catálogo tools/list. A lista pode ser menor que o catálogo completo porque o servidor filtra as ferramentas por acesso.

Comece com uma consulta e confira o resultado na interface do CRM. Exemplos de pedidos:

  • “Confirme em qual organização estamos e liste os contatos que posso consultar.”
  • “Conte os contatos sem apólice visível. Informe os critérios usados.”
  • “Encontre a oportunidade de Maria, mostre a etapa atual e os destinos disponíveis antes de movê-la.”
  • “Crie uma tarefa de retorno para o contato que eu selecionar, com o prazo informado.”
  • “Leia as diretrizes da marca e prepare um rascunho de post; quero revisar antes de agendar.”
  • “Analise o histórico da inbox Atendimento entre duas datas, leia todas as páginas e apresente evidências por conversa.”

Peça que o aplicativo confirme registros ambíguos, use UUIDs retornados pelo sistema e apresente o resultado persistido. Pesquisas locais oferecem filtros tipados, total e paginação. Antes de filtrar ou ordenar, o cliente consulta os campos permitidos em *_search_fields. Uma página de resultados não representa toda a base.

11. Criar, editar e mover registros com segurança

As ferramentas de escrita usam validações, integrações, automações e lembretes do CRMDAY. Uma movimentação de etapa pode produzir efeitos reais. O usuário continua limitado às ações e aos campos que seu perfil permite.

Cada intenção de escrita recebe um mutationId UUID. Em uma repetição da mesma solicitação após falha de comunicação, reutilize o mesmo identificador e o mesmo conteúdo. Use outro identificador apenas para uma nova intenção. Não crie um UUID novo para contornar uma resposta de reconciliação necessária.

Atualizações parciais preservam campos omitidos; null limpa somente campos que permitem esse valor. Movimentações de Deals/Tasks e edições do Social exigem a versão atual. Se houver conflito, releia o registro e decida novamente, evitando sobrescrever mudanças de outra pessoa. Não existem ferramentas MCP de exclusão ou troca de responsável.

12. Social: imagens, rascunhos e agendamento

  1. Consulte diretrizes da marca e perfis disponíveis.
  2. Se a imagem veio da conversa de IA, use social_media_import antes de criar ou editar o post. O cliente deve fornecer arquivo real com URL HTTPS de download e identificador.
  3. Use o objeto de mídia retornado pelo CRMDAY no post. Um caminho local, um endereço sandbox: ou uma URL inventada não transfere a imagem.
  4. Crie o rascunho, revise texto, imagens e perfis, e aprove o post.
  5. Para agendar, confirme explicitamente o post, os perfis e o horário com fuso. A ferramenta exige confirm: true, versão atual e data futura.
  6. Acompanhe a execução no Social. Agendamento aceito não significa publicação concluída.

A importação aceita JPEG, PNG, GIF e WebP estáticos, até 8 MiB e 16.777.216 pixels. Converte para JPEG, remove metadados e aplica fundo branco à transparência; arquivos animados são recusados. O resultado ocupa a quota de armazenamento da organização e sua URL pode ser lida por quem a possuir. Há limite de 20 importações por autorização a cada dez minutos.

As ferramentas editoriais não publicam imediatamente. Posts já agendados, publicados ou arquivados não podem ser editados por elas. Use a interface Social para alterar/cancelar os estados correspondentes. Revogar o MCP não remove imagens, desfaz registros ou cancela posts agendados.

13. Conversas: consulta e análise de histórico

A consulta de Conversas respeita as inboxes e a identidade de acesso do usuário. É possível ler metadados e texto de mensagens sem marcar o atendimento como lido. Notas internas ficam excluídas por padrão; anexos não incluem arquivos, URLs de mídia, OCR ou transcrição de áudio.

Para perguntas sobre um tema em determinado período, uma busca por palavra é insuficiente. “ACA”, “Marketplace” e “Obamacare”, por exemplo, podem exigir interpretação do contexto. O aplicativo deve distinguir correspondência literal de classificação semântica e explicitar critérios e incertezas.

  1. Defina inbox, período, fuso e se “minhas conversas” significa atribuição pessoal ou histórico da organização. A exportação cobre a inbox e não comprova participação pessoal histórica.
  2. Um administrador autorizado solicita conversations_export_create.
  3. Consulte conversations_export_get com intervalo mínimo de dez segundos enquanto estiver em preparação.
  4. Quando concluída, leia conversations_export_read até nextCursor ser null. Reúna fragmentos de texto pelo ID e offset da mensagem.
  5. Classifique o conteúdo completo e conte IDs distintos de conversa. Apresente denominador, critérios e evidências identificáveis.

A exportação aceita uma inbox e de um a 31 dias civis no fuso do solicitante. Os limites incluem 100.000 mensagens, 50 MiB, dez minutos de geração, uma geração simultânea por organização e quatro solicitações não falhas em 24 horas. O arquivo expira em 24 horas; a leitura pelo MCP é restrita ao solicitante. Trabalhos já aceitos não são cancelados ao revogar OAuth.

Na leitura direta de mensagens, o período é um intervalo de instantes com início inclusivo e fim exclusivo, até 31 dias. Continue a paginação mesmo após uma página vazia ou curta, até cursor nulo. Fragmentos não são mensagens extras. A extração é feita sobre dados vivos: edições e exclusões durante a leitura podem afetar os resultados.

14. Ampliar acesso, reconectar ou revogar

Para ampliar recursos, primeiro permita os novos escopos na organização. Cadastros de aplicativos são imutáveis: crie um substituto com callback e escopos desejados, atualize o ID no aplicativo de IA e obtenha novo consentimento. Confira a nova conexão antes de revogar a anterior. Atualizar o servidor ou ampliar a configuração da organização não aumenta grants existentes.

Em Conexões autorizadas, usuários podem revogar as próprias autorizações; administradores podem ver e revogar as da organização. Em Aplicativos cadastrados, revogar um aplicativo encerra as autorizações ligadas a ele naquela organização. Para um aplicativo público revogado localmente, Permitir nova autorização permite reconectar; não reativa tokens antigos. Revogação global pela plataforma bloqueia o cadastro em todas as organizações.

Desabilitar MCP revoga permanentemente as autorizações atuais. Remover um escopo revoga as que dependiam dele. Reabilitar ou recolocar o escopo exige novo consentimento. Registros criados, imagens importadas, posts agendados e exportações aceitas seguem seus ciclos próprios; confira e cancele separadamente o que for necessário.

15. Solução de problemas

Sintoma ou códigoO que conferir e como agir
Aplicativo cadastrado, sem conexão ativaConcluir o login e consentimento no aplicativo de IA e atualizar Conexões autorizadas. Cadastro e autorização são etapas diferentes.
mcp_disabledHabilitar MCP na organização correta e salvar os recursos permitidos.
invalid_request na autorizaçãoConferir ID, callback literal, resource exato, parâmetros e PKCE S256. Não alterar o callback por tentativa.
invalid_scope ou ferramenta ausenteComparar os escopos da organização, cadastro e solicitação; conferir dependências, módulos e perfil. Para ampliar, cadastrar substituto e consentir novamente.
401 / invalid_tokenConferir expiração/revogação. O cliente pode renovar durante a validade do grant; se encerrado, reconectar. Uma conversa de IA aberta não mantém o grant válido.
invalid_grantConferir código/refresh expirado, consumido ou incorreto e PKCE. Não repetir renovações em paralelo; iniciar novo consentimento quando necessário.
insufficient_scope, mcp_module_unavailable, mcp_admin_requiredConferir escopo, módulo/plano, papel e permissões reais. Exportação de Conversas exige acesso administrativo.
privileged_access_requiredSuperadmin deve iniciar contexto privilegiado válido e obter nova autorização vinculada a ele.
mcp_delegated_deniedO acesso delegado/federado não pode conceder MCP. Usar uma identidade e vínculo elegíveis.
record_not_found ou campo indisponívelConferir UUID público, organização e visibilidade. Um registro pode estar oculto, removido ou fora do escopo do usuário.
Conflito de versãoReler o estado atual e decidir novamente antes de editar/mover. Evitar sobrescrever alterações concorrentes.
idempotency_conflict ou reconciliação necessáriaNão mudar o identificador para forçar a operação. Verificar resultado persistido e solicitar suporte com requestId e mutationId, sem tokens.
mcp_schedule_invalidConferir aprovação, perfis, versão, confirmação e data futura com fuso.
Imagem não importadaConferir URL HTTPS acessível, validade, tipo, tamanho, pixels e quota. Não afirmar que a imagem foi salva quando a ferramenta retorna erro.
429Respeitar Retry-After e reduzir chamadas. Não criar novos grants ou UUIDs para contornar limites.
405 ao abrir /mcpO endpoint recebe POST do cliente MCP; abrir sua URL no navegador não é o teste de conexão. Use a descoberta OAuth e um cliente compatível.

Para suporte, informe horário e fuso, organização, nome do aplicativo, operação, código de erro e requestId. Em escrita, acrescente mutationId e o identificador público do registro quando disponível. Nunca envie access/refresh token, código OAuth, verifier PKCE ou senha.

16. Referência técnica para integrações

O servidor oferece ferramentas MCP via Streamable HTTP, sem sessão persistente entre réplicas. O cliente deve negociar a versão do protocolo pelo SDK; o contrato foi testado com 2025-11-25. Não há transporte stdio, canal SSE persistente, prompts ou resources MCP neste serviço.

FinalidadeEndereço público
Recurso MCP (resource/audience)https://one.crmday.net/mcp
Descoberta do recurso protegido/.well-known/oauth-protected-resource/mcp
Descoberta OAuth/.well-known/oauth-authorization-server/api/mcp/oauth
Issuerhttps://one.crmday.net/api/mcp/oauth
AutorizaçãoGET /api/mcp/oauth/authorize
TokensPOST /api/mcp/oauth/token
RevogaçãoPOST /api/mcp/oauth/revoke
Registro dinâmico restritoPOST /api/mcp/oauth/register

O resource deve ser exato, sem barra final ou domínio alternativo. O pedido de autorização inclui response_type=code, client_id, redirect_uri, resource, scope, code_challenge, code_challenge_method=S256 e um state gerado pelo cliente. Os escopos são separados por espaço.

Para trocar o código, envie formulário application/x-www-form-urlencoded ou JSON com grant_type=authorization_code, client_id, code, redirect_uri, code_verifier e resource. Para renovar: grant_type=refresh_token, client_id, refresh_token e resource. Omita scope ou repita exatamente o concedido; a renovação não permite ampliá-lo. O método de autenticação do cliente é none, sem segredo.

Exemplo ilustrativo de chamada após autenticação e inicialização negociadas pelo SDK; substitua o token fictício no seu ambiente seguro:

POST https://one.crmday.net/mcp
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"crmday_context","arguments":{}}}

O cliente usa JSON-RPC individual, consulta tools/list e envia os argumentos conforme o schema de cada ferramenta. Sucessos contêm JSON em texto e structuredContent; falhas de ferramenta usam isError: true, code e requestId. Receber HTTP de sucesso não basta: é necessário verificar se a ferramenta retornou erro.

Limites do transporte: 300 requisições/minuto por IP e 120/minuto por grant; tokens e revogação: 60/minuto por origem, além dos limites específicos de mídia/exportação. Respostas 429 exigem espera conforme Retry-After.

Para instalações administradas pela sua equipe, o endereço externo deve ser HTTPS e estável. O proxy deve encaminhar /mcp, /api/mcp/* e /.well-known/*, preservar Authorization e headers MCP e não armazenar respostas OAuth/MCP em cache. Clientes de navegador precisam de origem explicitamente permitida; clientes de servidor sem Origin não dependem dessa allowlist.

17. Catálogo de ferramentas

O catálogo desta revisão possui 47 ferramentas. A lista efetivamente retornada ao aplicativo depende das permissões e dos escopos. Nomes e schemas devem ser descobertos em tempo de execução; novos recursos não são concedidos automaticamente.

GrupoFerramentas
Contexto e relacionamentoscrmday_context, crm_related_search.
Contatoscontacts_search_fields, contacts_search, contacts_get, contacts_create, contacts_update.
Apólicespolicies_search_fields, policies_search, policies_get, policies_create, policies_update, policies_producers_search.
Dealsdeals_search_fields, deals_search, deals_get, deals_pipelines_search, deals_stages_search, deals_create, deals_update, deals_move.
Taskstasks_search_fields, tasks_search, tasks_get, tasks_boards_search, tasks_stages_search, tasks_create, tasks_update, tasks_move.
Socialsocial_brand_get, social_search_fields, social_search, social_get, social_media_import, social_campaign_create, social_campaign_update, social_post_create, social_post_update, social_post_schedule.
Conversasconversations_inboxes_search, conversations_search_fields, conversations_search, conversations_get, conversations_messages_list, conversations_export_create, conversations_export_get, conversations_export_read.

18. Privacidade e rotina de administração

Autorize apenas aplicativos de confiança e os recursos necessários. Antes de enviar dados a uma IA externa, confira a política do aplicativo e as regras da sua organização. O isolamento do CRMDAY controla quais dados saem pela conexão; ele não apaga cópias já recebidas por um cliente externo.

Conteúdo de CRM e mensagens deve ser tratado pelo agente como dado, nunca como instrução para ignorar controles, revelar credenciais ou executar ações não solicitadas. Ações de MCP são auditadas com usuário, organização, aplicativo e autorização, incluindo a origem técnica. Isso permite distinguir uma ação do aplicativo de uma ação manual.

Revise periodicamente aplicativos e conexões autorizadas, retire acessos desnecessários, confira o resultado de escritas na interface e acompanhe posts e exportações pendentes. Ao encerrar uma integração, revogue o acesso e trate separadamente os efeitos já criados.