> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectores, skills e plugins

> Conecte ferramentas externas e gerencie instruções reutilizáveis para programar.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

Adicione ferramentas e instruções reutilizáveis quando uma tarefa precisar de mais do que os arquivos do projeto. Conectores oferecem operações de serviços externos; skills fornecem instruções e plugins compatíveis agrupam componentes aceitos.

## Escolha o componente adequado

| Componente | O que oferece | Exemplo |
| - | - | - |
| Conector | Ferramentas de um serviço ou servidor MCP local. | Ler o relato de um bug. |
| Skill | Instruções reutilizáveis para um tipo de trabalho. | Seguir um fluxo de revisão ou geração de documentos. |
| Pacote de plugin | Um conjunto de componentes compatíveis. | Instalar skills e conectores juntos. |
| Marketplace | Uma fonte de pacotes. | Adicionar o repositório de pacotes do time. |

Uma skill não concede acesso a serviços por si só. Se precisar de uma ferramenta externa, configure também o conector e o acesso da conta.

## Conecte ferramentas externas

Um conector disponibiliza ferramentas de um serviço externo por meio do Model Context Protocol (MCP). Conecte seu sistema de acompanhamento de tarefas para usar as etapas de reprodução de um erro, ou um serviço de design para consultar especificações durante a implementação. As operações disponíveis dependem do servidor e do acesso concedido à sua conta.

1. Abra **Ajustes → Extensões** e escolha um conector do catálogo. Use **Novo servidor** para configurar um servidor MCP personalizado.
2. Conclua o login ou a configuração das credenciais e ative o conector.
3. Escolha **Testar** e examine as ferramentas descobertas. Um teste bem-sucedido confirma que o aplicativo consegue se conectar e listar as ferramentas do servidor.

Após o teste, informe na solicitação o serviço e os dados que o agente deve usar. Por exemplo, peça que leia o relato de um erro no checkout e use as etapas de reprodução para adicionar um teste de regressão. As chamadas aparecem na linha do tempo e seguem a política de permissões aplicável.

### Adicione um servidor MCP personalizado

Use **Novo servidor** quando o serviço não estiver no catálogo. Siga o transporte e a configuração documentados pelo servidor:

| Campo | O que informar |
| - | - |
| **Nome do servidor** | Nome único e reconhecível. |
| **Transporte** | HTTP ou SSE para URL, ou stdio para processo local. |
| **URL** | Endereço do servidor HTTP ou SSE. |
| **Comando** e **Argumentos** | Executável local e um argumento por linha para stdio. |
| **Diretório de trabalho** | Pasta de execução, se exigida. |
| **Cabeçalhos** ou **Variáveis de ambiente** | Pares nome-valor exigidos pelo servidor. |
| **Timeout (ms)** | Tempo de espera positivo para substituir o padrão, se necessário. |

Salve, conclua a autorização e execute **Testar**. Para stdio, executável e dependências precisam existir onde o conector roda. Um teste aprovado confirma conexão e descoberta de ferramentas; não garante acesso a todos os recursos.

### Use a conexão em uma tarefa

Informe o serviço e a entrada específica:

> Leia o bug de quantidades do checkout no sistema conectado. Resuma as etapas de reprodução, identifique o código e proponha um teste de regressão. Não altere o relato nem os arquivos ainda.

Examine os resultados na linha do tempo. Se um recurso estiver indisponível, confira identificador e acesso da conta. Se as ferramentas não aparecerem, confira a ativação e repita **Testar**. Mudanças de configuração valem na próxima execução; uma execução ativa mantém sua configuração.

<Frame caption="O catálogo de conectores mostra cada serviço e seu estado de conexão.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/extensions.jpg" alt="Conectores de GitHub, Linear e Notion com botões de conexão" width={2720} height={1800} x={750} y={420} cropWidth={1490} cropHeight={420} maxWidth="100%" />
</Frame>

## Skills e plugins

**Extensões** também gerencia skills e pacotes de plugins. Uma skill fornece instruções para um tipo de trabalho. Um pacote de plugin compatível pode incluir skills, conectores e outros componentes aceitos.

Na aba **Habilidades**, ative ou desative cada skill. Abra um pacote em **Pacotes** para examinar seus componentes. **Marketplaces** lista as fontes de pacotes; adicionar uma fonte pode disponibilizar mais pacotes para instalação.

Essa configuração é compartilhada por sessões locais de desktop, VS Code e CLI que usam o mesmo armazenamento.

### Instale e examine um pacote

1. Abra **Ajustes → Extensões → Pacotes** e confira origem e componentes.
2. Instale o pacote e confira seus componentes em **Habilidades** e **Conectores**.
3. Ative o necessário e conclua as autorizações.
4. Inicie uma execução com uma tarefa pequena que exercite o fluxo desejado.

Adicionar um marketplace permite descobrir pacotes; não conecta seus serviços automaticamente. Em **Marketplaces**, informe `owner/repo`, URL HTTPS ou caminho local em **Fonte do marketplace** e escolha **Adicionar**. Os controles de **Habilidades** definem quais instruções ficam disponíveis.

Desktop, extensão e CLI locais podem compartilhar a configuração pelo mesmo armazenamento. Um ambiente remoto tem configuração própria; consulte [Desenvolvimento remoto](/pt/docs/mka1-code/remote-development) antes de esperar que uma ferramenta local funcione nele.

Continue com [Início rápido](/pt/docs/mka1-code/first-task).