Como ligar o Claude, o Cursor e outras apps de IA com MCP
Cada workspace tem um servidor MCP. Apps de IA como o Claude, o Claude Code, o Cursor, o Codex e o Gemini CLI ligam-se com uma chave pessoal e depois leem e atualizam o seu trabalho em seu nome, com as suas permissões. O porquê está em MCP no Worknano. Esta página é a configuração.
Ativar (admins)
- Abra Organização e clique em Settings. Em MCP Server, ative Enable MCP Server. Fica desligado até um admin o ativar.
- Abra Config, clique em Integrations e depois em MCP Server. Cada app (Claude, Cursor, Codex, Gemini) é um modelo de ligação. Se desligar um modelo, todas as chaves criadas a partir dele deixam de funcionar.
- Escolha que modelos de dados cada modelo de ligação pode ler, criar ou atualizar. Apagar está desligado por predefinição.
- Em Permissions, MCP Permissions define o que as ligações externas podem fazer em todo o workspace. Consulte Permissões.
- Por predefinição, podem ligar-se Founders e Heads. Para que outras funções se liguem, dê-lhes permissão de criação em MCP Connection, em Permissions.
Ligar a sua app
- Abra My e clique em Integrations. Procure Worknano in other AI apps.
- Clique em Connect ao lado da sua app. A linha mostra a Server URL e a sua chave.
- Copie a Server URL. É o endereço do seu workspace com /mcp no fim, por exemplo https://yourcompany.worknano.com/mcp.
- Mostre e copie a chave. Começa por wnpat_. Só o próprio a pode mostrar, e cada visualização fica registada.
- Siga o guia na linha da sua app. Todas as apps precisam das mesmas duas coisas: a Server URL e um cabeçalho Authorization com o valor Bearer seguido da sua chave.
Claude Code, num só comando:
claude mcp add --transport http --scope user worknano https://yourcompany.worknano.com/mcp --header "Authorization: Bearer YOUR_KEY"
Cursor, em ~/.cursor/mcp.json:
{ "mcpServers": { "worknano": { "url": "https://yourcompany.worknano.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }
O Gemini CLI usa httpUrl em vez de url. O Codex precisa de Streamable HTTP e do mesmo cabeçalho. Na app Claude, adicione um conector personalizado, escolha No sign in e adicione o cabeçalho. Um conector que um owner adiciona para toda uma equipa Claude envia a mesma chave para todos, com as permissões dessa chave.
O que a app pode fazer
- Ler o workspace: modelos, campos, registos, contagens e agrupamentos.
- Criar e atualizar registos nos modelos que a sua ligação permite.
- Listar, ler e guardar ficheiros (HTML, texto e quadros).
- Propor alterações de config como rascunhos. Nada muda até um admin aprovar o rascunho no Worknano.
Cada chamada tem três limites: as definições MCP do modelo, as permissões da sua ligação e a sua própria função. Secrets, utilizadores, funções e integrações nunca ficam expostos.
Chaves, validade e desligar
- Uma chave dura 90 dias. Quando expira, a linha mostra Not connected. Clique em Connect para obter uma nova e cole-a na sua app.
- Clique em Disconnect para apagar a sua chave. A app perde o acesso de imediato.
O Worknano também pode usar outros servidores MCP nos seus próprios assistentes. É o MCP Client, um interruptor à parte, junto a Enable MCP Server. Chamar o Worknano a partir do seu próprio código está na documentação para programadores. Voltar ao mapa dos docs.