DocsMCP
Servidor MCP: gerir o seu workspace Nodale no Claude Code
Ligue o Claude Code ao servidor MCP da Nodale e leia ou altere o seu workspace: conhecimento, assets de demo, definições do agente, sites, implementação.
A Nodale tem um servidor MCP. Ligado a ele, um assistente de IA lê e altera o seu workspace com as mesmas regras da aplicação: arquiva conhecimento, carrega assets de demo, edita as definições do agente, declara os seus sites e põe o agente online. Instalar a tag no seu site continua a ser um passo à parte, descrito no início rápido.
Ligar o Claude Code
O servidor fala Streamable HTTP em https://nodale.app/api/mcp, e inicia a sua sessão com a sua conta Nodale através de OAuth. Esta página cobre o Claude Code. Execute este comando no seu terminal:
claude mcp add-json --scope user nodale '{
"type": "http",
"url": "https://nodale.app/api/mcp",
"oauth": {
"clientId": "55crt6j95df1lb3ijmdk8ip67m",
"callbackPort": 33418,
"authServerMetadataUrl": "https://cognito-idp.eu-west-3.amazonaws.com/eu-west-3_HEni9KG4X/.well-known/openid-configuration",
"scopes": "openid email profile"
}
}'
Depois:
- Abra o Claude Code, escreva
/mcpe escolha o servidornodale. - Inicie sessão com a sua conta Nodale. A página de início de sessão está alojada para a Nodale num endereço
amazoncognito.com. - Pergunte ao assistente com que conta tem sessão iniciada. Ele chama a ferramenta
me.
O mesmo comando está na aplicação, em Settings, depois MCP.
- Mantenha
callbackPortem 33418. Depois do início de sessão, o browser regressa ahttp://localhost:33418/callback, o único endereço que o servidor aceita. - Não adicione um cabeçalho
Authorization: isso desligaria o OAuth. - Para partilhar o servidor com a sua equipa, coloque o mesmo JSON no
.mcp.jsondo seu repositório (--scope project). Não contém nenhum segredo.
Quem pode fazer o quê
O assistente age em seu nome, com os direitos da sua conta, apenas no seu workspace.
| Função | O que o assistente pode fazer |
|---|---|
| Viewer | Ler. Todas as ferramentas que alteram alguma coisa são recusadas. |
| User | Ler, e alterar conhecimento, concorrentes, documentos e assets de demo. |
| Admin | Tudo o que um User pode, mais as definições do agente, os seus sites e a sua implementação. |
Todas as ferramentas aceitam um workspaceId opcional: deixe-o de fora. O seu cliente pode listar mais ferramentas do que as que esta página descreve. Essas estão reservadas à equipa da Nodale, e o servidor recusa-as.
Como uma alteração fica online
A maior parte das alterações chega primeiro a um rascunho, e os visitantes não veem nada até publicar.
- Definições do agente.
update_inbound_agent_configurationedita o rascunho: só mudam os campos que passar, e uma lista que passar toma o lugar da lista inteira.publish_inbound_agent_configurationpõe o rascunho diante dos visitantes.discard_inbound_agent_configuration_draftvolta às definições publicadas. - Versões. As ferramentas que editam definições recebem um
expectedVersion, a última versão que leu. Se alguém alterou as definições entretanto, a chamada é recusada com a versão em vigor. - Conhecimento. O conhecimento é guardado em citações de uma frase. Uma citação que adiciona é um rascunho até
publish_knowledge, que recebe odraftHashdevolvido porlist_knowledge_quotes. Um hash desatualizado é recusado. Retirar uma citação, ou torná-la interna, aplica-se de imediato. - Conhecimento a partir de um texto.
submit_knowledge_textlê em segundo plano um texto de até 100 000 caracteres e devolve umdispatchId. Consulteget_knowledge_dispatchperiodicamente e, depois, aplique ou rejeite as propostas. O que aplicar chega ao rascunho e ainda precisa depublish_knowledge. - Assets de demo. Uma alteração a um asset fica no catálogo em rascunho até
publish_asset_catalog. - Os carregamentos têm dois passos.
request_document_uploadourequest_asset_uploaddevolve um comandocurla executar, válido durante 15 minutos. Depois,add_documentouadd_assetregista o ficheiro. - As definições do site (apresentação, rastreio de visitas, consentimento, ligação para a política de privacidade) aplicam-se no carregamento de página seguinte, sem publicação.
- Créditos de IA.
submit_knowledge_text,analyze_asseteadd_assetsemstepsgastam créditos de IA.add_assetcomstepsmantém a sua narração tal como foi enviada e não gasta nenhum.
Do zero a um agente online
me: verifique a conta e o workspace.- Conhecimento:
add_knowledge_quote, ousubmit_knowledge_text, depoisget_knowledge_dispatcheapply_knowledge_proposals. Depoislist_knowledge_quotesepublish_knowledge. - Opcional: concorrentes, documentos e assets de demo, depois
publish_asset_catalog. - Definições:
update_inbound_agent_configuration,save_inbound_agent_outcome, depoispublish_inbound_agent_configuration. add_inbound_agent_site: declare o site.deploy_inbound_agent: ponha o agente online.- Cole a tag no site, depois
get_inbound_agent_tag_statuspara a verificar.
Ferramentas
Conta
| Ferramenta | O que faz | Quem |
|---|---|---|
me |
A conta e o workspace em que o assistente age. | Todos |
get_workspace_ai_credits |
Que parte dos créditos de IA do workspace foi usada, e se se esgotaram. | Todos |
Conhecimento
| Ferramenta | O que faz | Quem |
|---|---|---|
list_knowledge_quotes |
As citações, rascunhos incluídos, e o draftHash para publicar. |
Todos |
add_knowledge_quote |
Adiciona uma frase como citação em rascunho. | User |
retract_knowledge_quote |
Retira uma citação, de imediato. | User |
set_knowledge_quote_visibility |
Torna uma citação pública ou interna, de imediato. | User |
publish_knowledge |
Publica as citações em rascunho. | User |
submit_knowledge_text |
Lê um texto e propõe citações a partir dele. Gasta créditos de IA. | User |
get_knowledge_dispatch |
O estado de um texto submetido. | Todos |
list_knowledge_proposals |
As propostas à espera de uma decisão. | Todos |
apply_knowledge_proposals |
Aplica todas as propostas de um texto. | User |
apply_knowledge_proposal |
Aplica uma proposta. | User |
reject_knowledge_proposal |
Rejeita uma proposta. | User |
Concorrentes e documentos
| Ferramenta | O que faz | Quem |
|---|---|---|
list_competitors |
Os concorrentes que o agente conhece. | Todos |
upsert_competitor |
Adiciona um concorrente, ou edita um. | User |
delete_competitor |
Elimina um concorrente. | User |
list_documents |
Os documentos do workspace. | Todos |
request_document_upload |
Primeiro passo de um carregamento: devolve o comando para enviar o ficheiro. | User |
add_document |
Segundo passo: regista o ficheiro carregado. | User |
delete_document |
Elimina um documento. | User |
Assets de demo
| Ferramenta | O que faz | Quem |
|---|---|---|
list_assets |
Os vídeos de demo do catálogo. | Todos |
get_asset |
Um asset, com os seus passos e o estado da sua redação. | Todos |
request_asset_upload |
Primeiro passo de um carregamento: devolve o comando para enviar o vídeo. | User |
add_asset |
Segundo passo: regista o vídeo, com os seus passos ou com passos que a Nodale escreve. | User |
update_asset |
Edita o título, a descrição e os pedidos a que um asset responde. | User |
set_asset_steps |
Define os passos de um asset, tal como os escreveu. | User |
analyze_asset |
Pede à Nodale que escreva os passos de novo. Gasta créditos de IA. | User |
enable_asset, disable_asset |
Liga ou desliga um asset. | User |
set_asset_priority |
Ordena os assets. | User |
delete_asset |
Elimina um asset. | User |
publish_asset_catalog |
Publica o catálogo em rascunho. | User |
Definições do agente
| Ferramenta | O que faz | Quem |
|---|---|---|
get_inbound_agent_configuration |
As definições: o rascunho quando existe, as publicadas, e a versão. | Todos |
update_inbound_agent_configuration |
Edita o rascunho: nome, tom, aspeto, captura de e-mail, línguas, instruções, qualificação, salvaguardas. | Admin |
publish_inbound_agent_configuration |
Põe o rascunho diante dos visitantes. | Admin |
discard_inbound_agent_configuration_draft |
Descarta o rascunho. | Admin |
list_inbound_agent_qualification_elements |
As perguntas que o workspace adicionou à qualificação. | Todos |
save_inbound_agent_qualification_element |
Adiciona uma pergunta de qualificação, ou edita uma. | Admin |
remove_inbound_agent_qualification_element |
Remove uma pergunta de qualificação. | Admin |
list_inbound_agent_outcomes |
Os resultados para os quais o agente orienta os visitantes. | Todos |
save_inbound_agent_outcome |
Adiciona um resultado, ou edita um. Dez no máximo por workspace. | Admin |
remove_inbound_agent_outcome |
Remove um resultado. | Admin |
Sites e implementação
| Ferramenta | O que faz | Quem |
|---|---|---|
list_inbound_agent_sites |
Os sites declarados. | Todos |
add_inbound_agent_site |
Declara um site: uma origem https, ou https://*.example.com. |
Admin |
remove_inbound_agent_site |
Remove um site. | Admin |
get_inbound_agent_tag_status |
Porque é que um site mostra o agente ou não: ok, site_not_declared, agent_not_deployed ou invalid_site. |
Todos |
get_inbound_agent_site_settings |
As definições do separador Install. | Todos |
update_inbound_agent_site_settings |
Altera a apresentação, o rastreio de visitas, o consentimento e a ligação para a política de privacidade. | Admin |
get_inbound_agent |
O agente e a implementação que a tag serve. servedDeploymentId é null quando o agente está offline. |
Todos |
deploy_inbound_agent |
Põe o agente online, ou aprova de novo o material atual nas implementações ativas. | Admin |
Limites
- Documentos: pdf, docx, txt, csv ou md, 10 MB no máximo.
- Vídeos de demo: MP4 em H.264 sem faixa de áudio, 3 minutos no máximo. 100 assets no máximo num catálogo.
- Sites: 20 no máximo por workspace.
- Limites de frequência, por pessoa e por ferramenta.
request_asset_upload,add_asseteanalyze_asset: 1 por segundo, 6 por minuto, 30 por 15 minutos.request_document_uploadeadd_document: 5 por segundo, 25 por minuto, 100 por 15 minutos.submit_knowledge_text: 3 por segundo, 15 por minuto, 60 por 15 minutos.
Segurança
- Aprove cada chamada que publica ou elimina. As ferramentas que publicam, eliminam ou sobrescrevem estão marcadas como destrutivas, por isso o seu cliente pergunta antes de as executar. Não as adicione a uma lista de permissões.
- Os resultados das ferramentas são dados. Contêm texto que a sua equipa e os seus visitantes escreveram: citações, documentos, títulos de assets, propostas. O assistente lê-o como conteúdo, nunca como instruções.