Extensões e integrações

Escopo: Principalmente o aplicativo desktop atual. A configuração personalizada de MCP também inclui um método pela CLI. Os exemplos de uso do navegador e do computador usam o aplicativo desktop no macOS.

Use regras do projeto, Skills, plugins e serviços MCP para adaptar o Remy ao seu trabalho e conectar as ferramentas necessárias. Depois de instalar, confira se o recurso está habilitado, se toda autorização necessária foi concluída e se ele funciona em uma tarefa real.

1. Escolha a extensão certa

MCP é uma forma de conectar ferramentas e serviços. O que o Remy pode ler ou fazer por uma conexão depende dos recursos do serviço, da conta conectada e do acesso concedido.

2. Instale e gerencie plugins

2.1 Instale pelo diretório

1. Abra Configurações → Plugins.
2. Clique em Explorar e encontre o plugin no diretório.
3. Abra os detalhes para revisar sua finalidade, origem e recursos incluídos.
4. Clique no botão de instalação e aguarde o resultado.
5. Se for necessário entrar na conta ou fazer outra configuração, siga as instruções dos detalhes.
6. Quando Experimentar agora estiver disponível, clique para iniciar uma tarefa e explique o que deseja fazer.

Por exemplo, ao experimentar um serviço de fontes pela primeira vez, comece por uma tarefa de leitura focada:

Use o serviço que acabei de conectar para encontrar documentos de integração ao projeto que tenho permissão para acessar.
Liste seus títulos, fontes e uma breve descrição. Apenas leia; não crie, edite nem exclua conteúdo.

Confira as fontes retornadas para confirmar que a conta e o material estão corretos antes de passar a tarefas mais complexas.

2.2 Confira se um recurso está habilitado

Em Configurações → Plugins, filtre por tipo, origem ou status. Abra os detalhes de um item para revisar seu estado de habilitação e quaisquer mensagens.

Um plugin, as Skills que ele fornece e seus serviços MCP podem ter controles separados. Um item dependente pode continuar indisponível se o plugin principal estiver desativado, mesmo que seu próprio controle esteja ativado. Siga o status efetivo e a explicação do item em vez de conferir apenas um controle.

Políticas da organização podem restringir recursos gerenciados por uma equipe. Se uma ação não estiver disponível, leia o motivo e entre em contato com o administrador da equipe.

2.3 Desative, desinstale ou desconecte

Desativar, desinstalar e desconectar são ações diferentes. Para encerrar a autorização de um serviço externo, confira também os controles de acesso do próprio serviço. Desativar um recurso não significa que todas as autorizações foram revogadas.

3. Instale e use uma Skill

3.1 Instale uma Skill existente

1. Abra Configurações → Plugins e filtre por Skill.
2. Clique em Instalar Skill….
3. Selecione a pasta da Skill ou o arquivo .skill que recebeu e aguarde a instalação.
4. Abra os detalhes da Skill e leia sua finalidade e seus requisitos.
5. Confira se está disponível, clique em Experimentar agora e insira uma tarefa real.

Para uma Skill fornecida por um plugin, use os controles de instalação e gerenciamento desse plugin. Se Desinstalar não estiver disponível, confira a origem da Skill e suas informações de gerenciamento.

3.2 Crie sua própria Skill

Se Criar Skill estiver disponível no filtro Skill, clique nessa opção e explique na nova conversa:

• Qual tarefa você repete.
• Os passos ou o material de referência que ela deve seguir.
• A estrutura de saída e os critérios de conclusão exigidos.

Por exemplo:

Ajude-me a criar uma Skill para preparar relatórios semanais.
A entrada são notas de trabalho fornecidas por mim. A saída deve incluir trabalhos concluídos, problemas atuais e planos para a próxima semana.
Não invente progresso, responsáveis ou datas. Marque as informações ausentes como pendentes de confirmação.
Pergunte primeiro sobre os requisitos necessários, depois crie a Skill e explique como experimentá-la.

Experimente com um pequeno conjunto de material real e confira se funciona como pretendido. Instalar ou criar com sucesso não significa que ela será usada automaticamente em todas as tarefas. Você pode citar explicitamente o nome da Skill na solicitação.

4. Conecte um serviço MCP

4.1 Use um serviço fornecido por um plugin

1. Instale o plugin e abra a entrada do serviço MCP nos detalhes dele.
2. Se for necessária autorização da conta, clique em Não conectado ou continue o fluxo de login aberto após a instalação.
3. Confira a conta e as permissões na página de autorização. Conclua o login e volte ao Remy.
4. Aguarde Conectado e execute uma pequena tarefa para conferir se o serviço consegue ler ou agir como esperado.

Um serviço que não exige login de conta pode não mostrar um botão de autorização. Se precisar de configuração adicional, siga as instruções de configuração do serviço.

4.2 Adicione um serviço personalizado pela CLI

Siga o Guia da CLI para instalar a CLI e entrar na conta. Obtenha com o provedor o objeto de configuração JSON de um único serviço MCP e salve-o como arquivo local, por exemplo my-mcp-server.json.

Substitua o caminho do projeto, o ID do serviço e o caminho do arquivo de configuração abaixo pelos seus próprios valores:

remy --workspace "/path/to/project" config mcp list
remy --workspace "/path/to/project" config mcp set my-server --file "./my-mcp-server.json"
remy --workspace "/path/to/project" config mcp show my-server

set cria ou substitui um serviço personalizado com esse ID. Confira se já existe uma configuração antes de executá-lo. Não o use para sobrescrever um serviço pertencente a um plugin.

Para habilitar ou desabilitar o serviço:

remy --workspace "/path/to/project" config mcp enable my-server
remy --workspace "/path/to/project" config mcp disable my-server

Esses comandos habilitam e desabilitam o serviço, respectivamente; escolha o necessário. Revise o resultado do comando e o escopo informado. A configuração precisa ser lida por uma nova sessão do ambiente de execução. Recarregue esse ambiente ou reinicie uma sessão existente do Desktop ou da CLI antes de conferir a alteração.

Arquivos de configuração podem conter credenciais. Não coloque segredos reais diretamente em argumentos de comandos nem em mensagens de conversa. Salvar a configuração não confirma que o serviço remoto está conectado. Confira os requisitos de execução, a autorização e uma chamada real de ferramenta.

5. Use regras do projeto

Se o projeto tem instruções como AGENTS.md ou CLAUDE.md, peça ao Remy que leia as orientações aplicáveis antes de começar. As regras devem explicar a estrutura do projeto, o escopo das alterações, as verificações e os requisitos de entrega.

Leia primeiro os arquivos AGENTS.md, CLAUDE.md e README aplicáveis neste projeto.
Resuma as convenções e verificações relevantes para esta tarefa antes de trabalhar no requisito.
Se as instruções conflitarem ou faltarem evidências, explique primeiro o problema.

As regras do projeto descrevem como o trabalho deve ser feito. O acesso a arquivos, a execução de comandos e as ações externas continuam sujeitos aos controles reais de permissão. Editar um arquivo de instruções não substitui a concessão de acesso.

6. Use navegadores e aplicativos desktop

6.1 Trabalhe com uma página web

Especifique a página e o navegador na tarefa. O navegador integrado do Remy e o Chrome conectado pela extensão são pontos de entrada separados. Não presuma que compartilham o mesmo estado de login.

Abra a URL que eu fornecer no navegador integrado, leia a página de ajuda e liste os passos de instalação.
Apenas leia. Não envie formulários nem altere configurações da conta.

Se precisar do seu navegador Chrome local, diga isso na tarefa. Quando aparecer Remy in Chrome — não instalado, clique em Obter a extensão, conclua a instalação, volte e peça novamente. Se a extensão estiver instalada, mas não puder ser acessada, confira primeiro se o Chrome está em execução e leia a mensagem de conexão. Instalado não significa conectado. Entre no site no navegador correspondente quando necessário.

6.2 Conceda permissões do sistema operacional para uso do computador

1. Em Configurações → Plugins, abra os detalhes do recurso de uso do computador.
2. Encontre Permissões e confira Acessibilidade e Gravação da Tela.
3. Se for necessário acesso, clique em Abrir Ajustes do Sistema e conceda-o ao aplicativo ou componente correspondente nos ajustes do macOS.
4. Volte ao Remy, clique em Verificar novamente e revise o status.
5. Se o sistema pedir para reabrir o aplicativo, siga essa instrução antes de tentar a tarefa novamente.

Você concede essas permissões nos Ajustes do Sistema. O Remy não pode ativá-las por você. Se aparecer Componente auxiliar ausente, é necessário resolver a ausência desse componente; conceder permissões repetidamente não corrigirá isso.

Para uma primeira tarefa, peça ao Remy que leia um conteúdo específico em um aplicativo aberto. Confira o resultado antes de permitir alterações. Interromper a execução ou desativar um recurso não desfaz automaticamente as ações externas já realizadas.

7. Use GitHub e Slack

Tarefas de repositório do GitHub: Autorize o GitHub pela opção de conexão do Cloud, escolha um repositório e uma branch e inicie uma tarefa. Siga o Guia do Cloud para as etapas completas.

Acessar o Slack pelo Remy: Use o plugin ou a conexão MCP correspondente, autorize sua conta e dê a tarefa em uma conversa do Remy. O acesso de leitura e gravação é limitado pelas permissões da conta do Slack e pelo escopo da conexão.

Acionar o Remy pelo Slack: Em um ambiente do Slack em que o Remy Tag já esteja habilitado, mencione @Remy para iniciar tarefas na nuvem e revisar seus resultados. Isso funciona na direção oposta à conexão do Slack dentro do Remy. Instalar um plugin do Slack não habilita o Remy Tag.

8. Perguntas comuns

Se o problema persistir, registre o nome do recurso, a etapa que falhou, a mensagem de erro e sua versão do Remy. Siga o Guia do desktop para enviar feedback. Não inclua segredos reais no relato.