Adicionar servidores MCP e Skills

Adicione um servidor MCP quando um Agente precisar de ferramentas extras ou conexões com serviços. Adicione um Skill quando quiser reutilizar instruções e recursos para um tipo de trabalho. O Noea gerencia essas extensões de forma centralizada para conversas comuns entre Agentes.

As extensões são opcionais: você não precisa delas para começar. Tarefas de Explicar e de organização não usam as extensões adicionadas aqui.

Escolha a extensão necessária

A disponibilidade de um servidor também depende de o Agente oferecer suporte ao método de conexão dele. Para comandos de Skills, use a lista realmente exibida na conversa.

Adicione um servidor MCP

Abra Ajustes → Servidores MCP, adicione um servidor, digite um nome e escolha o método de conexão.

• stdio: inicia um serviço localmente. Informe o comando, os argumentos e as variáveis de ambiente necessárias, com um argumento por linha.
• HTTP: conecta a um serviço por URL. Informe o endereço do servidor e os cabeçalhos necessários.

Se o serviço fornecer uma configuração JSON compatível, use Colar JSON para preencher o formulário. Confira o comando, o endereço e os campos de autenticação antes de salvar.

Os nomes devem ser únicos, sem diferenciar maiúsculas e minúsculas. Nomes que começam com noea são reservados. A primeira linha é o servidor integrado do Noea, que está sempre ativado e não pode ser apagado.

Teste a conexão

Testar conexão no painel de edição usa os valores atuais do formulário. Testar pela lista usa a configuração salva.

Um teste bem-sucedido mostra os nomes e a quantidade de ferramentas. Uma falha identifica a etapa, como comando ausente, encerramento do processo, tempo limite, solicitação rejeitada ou falha na negociação da conexão. Se um serviço HTTP exigir autorização, siga o fluxo de autorização do Agente selecionado.

Um teste bem-sucedido significa que a configuração consegue conectar. Não garante suporte de todos os Agentes nem ativa automaticamente o servidor para uma conversa.

Ative um servidor para uma conversa

A configuração de padrão para novas conversas na lista de servidores determina a seleção inicial. Você também pode escolher servidores MCP para uma conversa específica no menu de configuração dela.

A escolha é salva com a conversa. Um Agente conectado não recarrega imediatamente as configurações alteradas; elas entram em vigor na próxima conexão. Para usar uma nova configuração, inicie uma nova conversa e confira a seleção de servidores.

O menu explica por que um servidor está indisponível, como uma variável de ambiente ausente ou um método de conexão não compatível.

Use variáveis de ambiente

Valores de variáveis de ambiente e de cabeçalhos aceitam referências ${VAR} a variáveis no ambiente de execução do Noea. Os valores são lidos ao conectar. Teste a conexão após configurar. Executar export em um terminal não garante que um processo do Noea já em execução tenha esse valor.

Os campos ocultam os valores por padrão e podem revelá-los ao clicar. Ocultar um valor apenas impede sua exibição; não altera como a configuração é salva ou usada.

Adicione um Skill

Abra Ajustes → Skills, escolha a ação de adicionar e selecione uma pasta contendo SKILL.md. O aplicativo explica eventuais problemas de formato.

O Skill é adicionado à biblioteca do Noea. Adições e remoções entram em vigor em novas conversas. Você pode mostrar a localização no gerenciador de arquivos. Apagá-lo remove a cópia da biblioteca, não a pasta original selecionada.

A mesma página mostra Skills somente leitura, de nível de usuário e de projeto, encontrados nos diretórios dos Agentes. Veja suas localizações ou escolha Copiar para o Noea. Essa lista não inclui todos os Skills integrados aos Agentes ou fornecidos pelos plugins deles.

Use extensões em uma conversa

Inicie uma nova conversa e digite / no começo do campo de entrada para navegar pelos Skills do Noea e comandos do Agente. Selecione um item disponível, acrescente os requisitos da tarefa atual e envie.

Se uma extensão estiver ausente, confira se iniciou uma nova conversa e se o Agente oferece suporte a ela; depois consulte Solução de problemas.