EasyGerber

Projeto e roteamento de PCB com IA

Servidor MCP hospedado

npx add-mcp 'https://www.easygerber.com/api/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

EasyGerber: Projeto, layout e roteamento de PCB com IA

Este pacote conecta agentes de codificação às ferramentas hospedadas de design de placas da EasyGerber. Seus arquivos públicos contêm instruções de fluxo de trabalho, metadados de conexão, ícones e um pequeno instalador. Layout de placas, roteamento e pontuação são executados nos servidores da EasyGerber.

Este pacote e suas instruções de plugin são a versão 0.3.4. Ele adiciona orientação submit_feedback para relatórios de bugs aprovados pelo usuário, solicitações de recursos e feedback geral enviados para a caixa de entrada privada do administrador da EasyGerber. Um relatório não precisa de conta ou nova placa. Para trabalho em novas placas, ele inicia uma placa de convidado diretamente quando o status da conta é desconhecido, sem sondar ferramentas exclusivas de conta, como get_profile primeiro. Sessões de convidado existentes e contas autorizadas são reutilizadas. Também inclui instruções para exclusão de placas de conta autorizada separadamente. Ferramentas hospedadas são descobertas dinamicamente quando o serviço conectado as anuncia. Estas instruções não expandem concessões OAuth existentes ou os escopos padrão do instalador.

O código-fonte está disponível no repositório público de integração. O instalador npm e os pacotes de plugin de plataforma têm processos separados de validação de cliente e compartilham a habilidade de fluxo de trabalho EasyGerber e o serviço hospedado.

Comece sem se inscrever

Use https://www.easygerber.com/api/mcp para acesso prioritário a convidados. Nenhuma conta EasyGerber, concessão OAuth ou chave de API é necessária para conectar, inicializar ou descobrir ferramentas. Um agente inicia uma sessão privada com start_guest_session, depois usa seu guestToken para pesquisas no catálogo e trabalho na única placa dessa sessão, incluindo layout, verificações, visualizações e exportações. Mantenha o token e o link do visualizador privado em sigilo.

URL de conexão	Quando usar	Login
`https://www.easygerber.com/api/mcp`	Conexões MCP gerais e listagens de diretório prioritárias para convidados	Não obrigatório para convidados; obrigatório para placas de conta, acesso à organização e salvar uma placa de convidado em uma conta
`https://www.easygerber.com/api/mcp/account`	Placas de conta salvas em clientes que solicitam OAuth apenas durante a configuração	Obrigatório antes da inicialização ou descoberta de ferramentas; esta conexão não inicia no modo convidado

O instalador Codex, os pacotes OpenAI e o pacote Claude usam a URL geral. O conector de conta Grok e as configurações nativas do Cursor e Antigravity abaixo usam a URL somente de conta. Para uma nova conexão de convidado, deixe a autenticação não definida; uma credencial de conta existente rejeitada deve ser reautorizada e não se tornará silenciosamente uma conexão de convidado. Consulte Experimente antes de se inscrever para limites de sessão e como salvar uma placa de convidado.

Grok

Conecte sua conta EasyGerber uma vez para abrir e editar placas salvas no Grok de consumo:

No Grok, abra Plugins → Novo Conector → Personalizado.
Nomeie o conector como EasyGerber e insira https://www.easygerber.com/api/mcp/account como URL do servidor.
Conclua o login na EasyGerber e escolha Permitir acesso. Em seguida, peça ao Grok para abrir uma placa salva pelo URL da EasyGerber e fazer as alterações solicitadas.

Por exemplo: "Abra esta placa EasyGerber salva: [URL da sua placa]. Renomeie-a para indicador de LED e leia-a novamente para confirmar que a alteração foi salva."

Esta entrada de conta exige autorização durante a configuração da conexão e usa as ferramentas e permissões de conta EasyGerber existentes. Para uma nova conexão à entrada de conta, conclua seu fluxo de login normal. As configurações de pacote publicadas existentes continuam usando /api/mcp, que suporta uso de convidado e autorização de conta opcional.

Em 16 de outubro de 2026, o Grok de consumo concluiu o consentimento, leu uma placa privada salva existente, salvou uma alteração temporária de nome e restaurou o nome original. Ambas as alterações foram confirmadas após reabrir a placa no site da EasyGerber. O Grok Bot não foi testado. A renderização 3D no navegador não foi verificada porque o WebGL não estava disponível no navegador de teste. Esta verificação de consumo não estabelece o OAuth interativo do Grok Build ou o fluxo de trabalho de placas orientado por modelo.

Cursor

O repositório público inclui um manifesto nativo .cursor-plugin/plugin.json. Ele usa a habilidade e os recursos visuais compartilhados da EasyGerber e se conecta a https://www.easygerber.com/api/mcp/account. Esta entrada exige autorização de conta antes que as ferramentas fiquem disponíveis; conclua o login na EasyGerber e escolha Permitir acesso no fluxo de conexão do Cursor. Permissões de conta, limites de plano e cobrança de geração ainda se aplicam.

Para carregar um checkout do repositório público no CLI oficial do Cursor:

agent --plugin-dir .

Insira /mcp, selecione Easygerber (plugin) e escolha Gerenciar Servidor → Login para concluir o fluxo de consentimento no navegador. Em seguida, pergunte: "Abra esta placa EasyGerber salva: [URL da sua placa]. Leia seu nome e componentes atuais." O Cursor gerencia as credenciais da conta. O instalador npm não é necessário; ele configura apenas o Codex. As configurações de conexão raiz do OpenAI e do Claude mantêm acesso /api/mcp compatível com convidados. A publicação no marketplace está sujeita à revisão do Cursor.

Antigravity

Projete e faça o layout de PCBs no Antigravity usando componentes publicados, posicionamento e roteamento automáticos, edição de esquemáticos e exportações de fabricação. O repositório público inclui metadados nativos do Antigravity e a habilidade compartilhada da EasyGerber. Sua conexão MCP usa https://www.easygerber.com/api/mcp/account; permissões de conta, limites de plano e cobrança de geração ainda se aplicam.

Instale o plugin do repositório público com o CLI atual do Antigravity e inicie uma sessão:

agy plugin install https://github.com/EasyGerber/easygerber-agent-plugin
agy

Use /mcp para inspecionar a conexão EasyGerber. Conclua o login na EasyGerber e escolha Permitir acesso quando o Antigravity solicitar autorização de conta. Em seguida, pergunte: "Abra esta placa EasyGerber salva: [URL da sua placa]. Leia seu nome e componentes atuais." O Antigravity gerencia as credenciais da conta. O instalador npm não é necessário. A publicação no marketplace está sujeita à revisão do Antigravity.

Consulte o guia de plugin e o guia MCP oficiais.

Cline

O Cline pode se conectar diretamente ao endpoint MCP hospedado da EasyGerber usando Streamable HTTP. Use uma instalação existente do Cline com um modelo configurado. O instalador de configuração npm neste repositório configura apenas o Codex; não é o caminho de instalação do Cline. Nenhum servidor EasyGerber local, build ou chave de API é necessário para uma nova conexão de convidado.

No painel do IDE do Cline, abra Servidores MCP → Servidores Remotos, insira EasyGerber como nome do servidor e https://www.easygerber.com/api/mcp como URL do servidor, escolha Streamable HTTP e selecione Adicionar Servidor. Deixe a autenticação não definida para acesso de convidado.

Alternativamente, abra Servidores MCP → Configurar → Configurar Servidores MCP e mescle esta entrada no objeto mcpServers existente, preservando outros servidores e configurações:

{
  "mcpServers": {
    "easygerber": {
      "type": "streamableHttp",
      "url": "https://www.easygerber.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

O tipo explícito streamableHttp é importante: omiti-lo seleciona SSE legado no Cline. Mantenha a aprovação de ferramentas ativada. Se easygerber já existir, inspecione essa entrada em vez de substituí-la ou criar uma duplicata.

Com o CLI atual do Cline, o comando de configuração equivalente é:

cline mcp add easygerber https://www.easygerber.com/api/mcp --transport http --yes

Este comando salva a conexão; por si só, não prova a configuração bem-sucedida. No Cline, verifique se a conexão é bem-sucedida e se ferramentas EasyGerber como search_parts, get_part e start_guest_session aparecem. Para uma verificação apenas de instalação, pare após a descoberta de ferramentas; não inicie uma sessão de convidado, crie ou modifique uma placa, gere um layout, exporte arquivos ou envie feedback.

Para trabalho posterior em placas solicitado pelo usuário, o acesso de convidado suporta uma placa por sessão antes da inscrição. Placas de conta salvas exigem consentimento OAuth da EasyGerber. Clientes que exigem autorização durante a configuração da conexão podem usar a entrada separada https://www.easygerber.com/api/mcp/account descrita acima. Autorização de conta e fluxos de trabalho de placas precisam de sua própria validação no Cline; a verificação de conexão de convidado não os valida.

Estas instruções seguem o guia MCP oficial do Cline. Em 18 de outubro de 2026, o Cline CLI 3.0.73 leu o README proposto e escreveu a configuração de conexão nativa em um perfil isolado vazio com aprovações de ferramentas ativadas. Uma verificação separada usando seu @cline/core 0.0.95 instalado conectou e descobriu 17 ferramentas EasyGerber sem autenticação. O agente em si não verificou a descoberta. Nenhuma ferramenta EasyGerber foi chamada; OAuth e operações de placa não foram testados.

Kiro

Instale a power folder do Kiro através de Powers → Adicionar Power Personalizado, ou execute kiro-cli --v3 powers install ./kiro a partir de um checkout local deste repositório público e inicie kiro-cli --v3. O instalador npm não é necessário. A power usa a entrada /api/mcp compatível com convidados e inclui o fluxo de trabalho completo da EasyGerber em sua habilidade.

Em 18 de outubro de 2026, o Kiro CLI 2.32.0 V3 importou e ativou explicitamente a power, leu sua habilidade completa e descobriu 17 ferramentas hospedadas sem autenticação EasyGerber. Seu fluxo de trabalho nativo de convidado selecionou peças publicadas, criou e revisou uma placa, concluiu a geração de layout, leu dados de visualização, verificou bloqueios e exportou arquivos de fabricação e EasyGerber. Uma conexão /api/mcp/account configurada separadamente concluiu o OAuth e salvou com sucesso essa placa de convidado em uma conta pessoal após retomar a mesma conversa; uma leitura subsequente confirmou a placa da conta e seu layout salvo. Uma verificação separada no navegador renderizou as peças 3D da placa salva.

O OAuth automático de meio de sessão da power não foi concluído nesta versão do CLI. Use a conexão de conta opcional e as instruções de retomada no README do Kiro para trabalho de conta e salvamento de placa de convidado. Conclua o consentimento no navegador enquanto o listener de callback local do Kiro estiver ativo; uma tentativa anterior de endpoint de conta expirou após cerca de 60 segundos, separadamente do erro de estado de autorização de meio de sessão da power. Renovação de token, exclusão, feedback e ativação somente por palavra-chave permanecem não testados no Kiro. A aprovação de diretório é separada dessas verificações.

Codex no VS Code ou no terminal

Requer Node.js 22 ou mais recente e Codex. Para instalar a versão 0.3.4:

npx @easygerber/agent-plugin@0.3.4 setup --dry-run
npx @easygerber/agent-plugin@0.3.4 setup
npx @easygerber/agent-plugin@0.3.4 doctor

A instalação instala ~/.agents/skills/easygerber e adiciona uma pequena tabela MCP gerenciada a $CODEX_HOME/config.toml (padrão ~/.codex/config.toml). Ela preserva o texto TOML existente e outros servidores. Um recibo de propriedade fica em ~/.easygerber/agent-plugin/codex-install.json. Nenhum arquivo de projeto ou firmware é alterado. O Codex é o alvo padrão e único do instalador; --client codex opcional torna essa escolha explícita. Todos os comandos suportam uso não assistido, e --yes é aceito para scripts.

Reinicie o chat/IDE do Codex após a configuração e pergunte: "Crie uma pequena placa de LED de 3,3 V, mostre uma visualização e exporte os arquivos de fabricação e o arquivo EasyGerber." O agente usa sua conta conectada ou inicia uma placa de convidado automaticamente através de https://www.easygerber.com/api/mcp.

Para suas placas de conta salvas ou trabalho de organização, conecte a EasyGerber nas configurações do MCP. Se o Codex CLI estiver instalado, execute:

codex mcp login easygerber

O cliente abre o fluxo de autorização de conta e armazena suas credenciais. A configuração MCP gerenciada solicita boards:read, boards:write, boards:generate, boards:export e offline_access, então o consentimento da conta cobre fluxos de trabalho comuns de placas e acesso renovável, sem exclusão. A exclusão requer consentimento separado e explícito de boards:delete; uma concessão boards:write existente é insuficiente. Permissões de organização, limites de conta e o consentimento do usuário ainda controlam o acesso à conta. O instalador nunca solicita, lê ou armazena tokens de acesso ou capacidades de convidado. doctor verifica a configuração local e a integridade da habilidade; não prova que autenticação, modo convidado ou o serviço ao vivo funcionam.

Experimente: "Use a EasyGerber para criar uma placa a partir das atribuições de pinos neste firmware." O agente lê o código local relevante, seleciona peças publicadas e envia os requisitos da placa através do serviço MCP. Escopos comuns de conta são boards:read, boards:write, boards:generate e boards:export; permissões de organização, cotas e cobrança ainda se aplicam.

Experimente antes de se inscrever

Acesso de convidado está ativo no serviço MCP de produção do EasyGerber e usa o catálogo de componentes publicado. O agente pode criar uma placa por sessão com edições, layouts, verificações, pré-visualizações e exportações de ZIP de fabricação ou .egb ilimitados antes do cadastro. A placa e a sessão não têm expiração automática. As proteções normais de taxa de solicitação, complexidade da placa e computação compartilhada ainda se aplicam. O serviço retorna limits: { boards: 1 }; expiresAt: null significa que não há expiração agendada. O limite de placas se aplica a uma sessão, não a uma pessoa verificada.

O agente mantém o recurso de convidado no contexto de suas ferramentas. Mantenha o link privado do visualizador para retornar à placa; qualquer pessoa com esse link pode acessar o design de convidado. Nem o token bruto nem esse link pertencem a repositórios de firmware, issues públicas ou logs de diagnóstico. O visualizador remove o fragmento do token e usa uma sessão de navegador privada. O acesso de convidado depende de manter esse recurso ou link; criar outra sessão não pode recuperar uma perdida. Links de download expiram após quinze minutos, e objetos de exportação tornam-se elegíveis para limpeza vinte e quatro horas após a criação. Esses limites de artefatos não expiram a placa de convidado.

Para propriedade de conta, recuperação baseada em conta e placas adicionais sob seu plano normal, entre ou crie uma conta a partir do visualizador privado. O visualizador salva a placa na sua conta pessoal automaticamente após essa transferência de login. Simplesmente abrir uma pré-visualização de convidado em um navegador já conectado a deixa como uma placa de convidado. Em uma tarefa de agente com uma placa de convidado, escolher trabalho de login ou placa de conta também inclui salvar essa placa sem uma confirmação separada de Manter placa, exceto ao entrar somente para excluir uma placa de conta ou enviar feedback: o agente usa claim_guest_board com o token de convidado original para iniciar a autorização e repete a reivindicação após o consentimento normal da conta. O Autenticar genérico das Configurações nativas não tem contexto de placa de convidado, então o agente deve retomar a reivindicação após esse login; o callback sozinho não salva a placa.

Uma reivindicação bem-sucedida retorna um novo ID de placa de conta e encerra o acesso de convidado. O agente lê essa placa de conta antes de fazer outras alterações. Se o layout ainda estiver em execução, ele espera e tenta novamente automaticamente sem cancelar o trabalho; se a reivindicação falhar ou sua resposta for perdida, ele retém o token original para uma nova tentativa segura. Reutilize a sessão de convidado original; não crie sessões extras para contornar o limite de placas ou as proteções do serviço. Uma conexão de conta expirada deve ser reautorizada; ela não se torna silenciosamente uma conexão de convidado.

Excluir uma placa de conta

Peça explicitamente para excluir uma placa de conta especificada. O agente lê sua revisão atual e chama delete_board somente para essa solicitação. A exclusão é permanente, não tem operação de restauração e cancela trabalhos ativos na placa. Criar, editar ou exportar uma placa não autoriza exclusão ou limpeza.

A exclusão requer consentimento OAuth separado de boards:delete e propriedade pessoal ou função de proprietário/administrador da organização. O instalador e as configurações padrão do cliente não solicitam esse escopo; o cliente deve suportar a obtenção da aprovação adicional. Uma concessão existente de boards:write não pode excluir placas. Um registro de cliente limitado aos escopos anteriores deve ser deliberadamente atualizado ou substituído pelo fluxo normal de reconexão ou registro do cliente antes de solicitar consentimento de exclusão. Registros e concessões existentes não ganham acesso de exclusão automaticamente. Placas de convidado não podem ser excluídas por esta ferramenta, e o agente não deve reivindicar uma apenas para excluí-la. Entrar somente para excluir uma placa de conta não autoriza reivindicar uma placa de convidado não relacionada.

Para a conexão easygerber do instalador do Codex, que não tem ID de cliente OAuth configurado, opte explicitamente pela exclusão com estes comandos, verificados com o CLI do Codex 0.163.0-alpha.10.2:

codex mcp logout easygerber
codex mcp login easygerber \
  --scopes boards:read,boards:write,boards:generate,boards:export,boards:delete,offline_access \
  --oauth-client-registration dcr

Sair limpa o ID de cliente e os tokens armazenados em cache localmente. Entrar cria um novo registro dinâmico de cliente com os escopos listados e abre o navegador para novo consentimento, incluindo exclusão. Essas flags se aplicam a este login; elas não alteram os escopos gerenciados pelo instalador em config.toml. Sair não revoga o cliente ou a concessão anterior no lado do servidor. Veja a implementação de seleção de escopo e logout do CLI do Codex.

Uma conexão com um ID de cliente OAuth configurado ignora o registro dinâmico mesmo com esta flag. O registro do provedor deve permitir boards:delete antes que o cliente possa obter novo consentimento; os comandos acima não são uma correção geral para plugins nativos ou outros clientes. Veja registro de cliente OAuth do Codex. Após a autorização, o agente ainda lê a placa de conta especificada novamente e exclui somente sob solicitação explícita do usuário.

Somente uma resposta bem-sucedida de { boardId, deleted: true } confirma a exclusão. Com o escopo OAuth necessário, placas indisponíveis, propriedade insuficiente e solicitações repetidas para uma placa ausente retornam not_found; esse resultado não prova que uma exclusão ocorreu. Se a resposta for perdida, o agente relata incerteza em vez de tratar um resultado posterior de placa ausente como confirmação.

Enviar feedback

Peça ao seu agente para enviar ao EasyGerber um relatório de bug, solicitação de recurso ou feedback geral. Ele usa submit_feedback somente quando você pede ou concorda, enviando uma mensagem concisa de 10–2000 caracteres após o corte para uma caixa de entrada privada de administrador. Ele não envia automaticamente transcrições, diagnósticos brutos, exportações de placas, credenciais ou links privados. Um envio bem-sucedido retorna um ID de recibo e um carimbo de data/hora; não promete uma resposta ou um compromisso de roadmap.

A conexão geral /api/mcp aceita feedback anônimo sem entrar, iniciar uma sessão de convidado ou criar uma placa. Uma conta já conectada ou uma sessão de convidado válida existente pode atribuir o relatório. Nenhum escopo adicional de placa é necessário, e os escopos padrão do instalador permanecem inalterados. Credenciais existentes inválidas permanecem negadas em vez de se tornarem silenciosamente anônimas. Entrar somente para enviar feedback não autoriza reivindicar uma placa de convidado. A conexão somente de conta ainda exige login durante a configuração.

O agente mantém o mesmo UUID requestId e conteúdo de relatório e atribuição idênticos ao tentar novamente um envio incerto. Se a ferramenta, conexão ou serviço estiver indisponível, use GitHub Issues. Issues do GitHub são públicas e exigem uma conta do GitHub para postar: revise e edite seu relatório antes de publicar, e nunca inclua credenciais, links privados ou dados confidenciais de placas.

Plugins do ChatGPT e Codex nativo

O manifesto raiz portátil e mcp.json suportam revisão para o diretório de plugins da OpenAI. Eles declaram acesso misto público e OAuth: convidados podem descobrir ferramentas sem autorização de conta, e operações de conta usam um cliente OAuth público registrado com PKCE e consentimento normal. Seu ID de cliente é metadado público, não uma credencial. Isso não altera o registro automático do Codex do instalador npm. Descoberta de convidado e autorização opcional de conta precisam de verificações separadas em cada cliente; a validação do pacote não estabelece aprovação do diretório ou aceitação do cliente nativo. O pacote nativo do Codex usa um manifesto compatível separado e arquivo MCP com descoberta automática de OAuth; ele não copia o ID de cliente somente do diretório. Use esse pacote nativo em um cliente desktop suportado, ou a instalação autônoma acima para Codex no terminal e IDE. O ZIP portátil do diretório não é intercambiável com o ZIP nativo. Evite instalar integrações duplicadas no mesmo cliente.

Para placas de conta salvas em conectores personalizados que solicitam autorização de conta somente durante a configuração, use https://www.easygerber.com/api/mcp/account e complete o login e o consentimento ao conectar. Esta entrada de conta exige OAuth antes da inicialização e usa as mesmas ferramentas, permissões e serviços de placa. Para acesso primeiro de convidado, use https://www.easygerber.com/api/mcp; a autorização de conta é opcional nessa conexão.

As duas entradas têm recursos OAuth distintos. Inicie uma nova conexão ao escolher a entrada de conta; registros de cliente e tokens existentes permanecem vinculados ao seu recurso original. Não copie tokens entre entradas. Os manifestos de pacote publicados mantêm sua URL de conexão existente.

Claude

O pacote Claude é preparado na pasta claude do repositório público, com .claude-plugin/plugin.json e .mcp.json. Ele compartilha a habilidade, arte e serviço hospedado do EasyGerber com os pacotes da OpenAI. O instalador npm permanece somente para Codex. Para validação local e carregamento com Claude Code 2.1.281 ou mais recente, a partir de um checkout do repositório público:

claude plugin validate ./claude --strict
claude --plugin-dir ./claude

Use /mcp no Claude Code para inspecionar a conexão do EasyGerber e autorizar acesso de conta quando necessário. No chat e no Cowork do Claude, adicione ou conecte o EasyGerber pela aba Connectors do plugin. O EasyGerber é aprovado e publicado no diretório do Claude, com acesso de convidado por meio de /api/mcp.

Atualizar e remover

Execute npx @easygerber/agent-plugin@0.3.4 setup e reinicie o chat/IDE do Codex para carregar as instruções atuais de início de convidado, salvamento de conta, exclusão e feedback. Atualizar da versão 0.2.x também substitui o nome aposentado score_board por check_board_layout; nenhum alias de compatibilidade é fornecido.

Execute setup a partir da nova versão do pacote para atualizar arquivos gerenciados inalterados. Repetir a mesma configuração é uma operação sem efeito. Uma entrada MCP conflitante ou um arquivo de habilidade modificado faz a configuração parar sem substituí-lo. Mantenha o arquivo ou mova-o para o lado você mesmo antes de tentar novamente. Destinos gerenciados com symlink são recusados para evitar alterar locais inesperados.

npx @easygerber/agent-plugin@0.3.4 uninstall --dry-run
npx @easygerber/agent-plugin@0.3.4 uninstall

A desinstalação remove somente arquivos inalterados e a conexão gerenciada inalterada, preservando configurações não relacionadas e arquivos modificados. Ela relata caminhos preservados e retém seu recibo de propriedade. Revogue a conexão de conta separadamente no Codex ou no EasyGerber; excluir arquivos locais não revoga concessões OAuth nem invalida um link de visualizador de convidado existente. O acesso de convidado termina após reivindicação ou revogação, não em um temporizador automático. Dados de convidado aposentados tornam-se elegíveis para limpeza vinte e quatro horas após reivindicação ou revogação; a cópia de conta reivindicada permanece disponível. Configuração interrompida pode retomar a partir de seu recibo. Se um bloqueio de instalador obsoleto permanecer, verifique se nenhum processo do instalador está em execução antes de remover o caminho do bloqueio relatado pelo CLI.

Rede e dados

A integração conecta diretamente a https://www.easygerber.com/api/mcp, ou /api/mcp/account para as configurações nativas do Cursor e Antigravity e o conector de conta Grok do consumidor; a autorização usa os metadados e o fluxo de conta anunciados pela entrada selecionada. Solicitações de ferramenta podem conter os requisitos da placa, seleções de componentes, edições de esquemático, identificadores de placa/organização e mensagens de feedback que você aprova para sua tarefa. Links de artefatos gerados são retornados pelo EasyGerber. O serviço hospedado retém análises de atividade do agente por um ano, incluindo histórico de convidado após uma placa ser reivindicada. O instalador não envia repositórios, inspeciona arquivos de ambiente, executa hooks de ciclo de vida nem coleta telemetria. A recuperação comum de pacotes npm é tratada pelo npm.

Veja documentação de integração e suporte, política de privacidade e termos.

Validação e lançamento do mantenedor

O repositório server.json declara a versão 0.1.1 da entrada do Registro MCP io.github.EasyGerber/easygerber, usando a URL geral https://www.easygerber.com/api/mcp para descoberta de convidados e autorização opcional de conta. Diretórios que importam metadados do Registro devem usar essa URL para acesso prioritário de convidados. Configurações de clientes somente com conta permanecem disponíveis separadamente, conforme descrito acima. O manifesto é exportado apenas para o repositório público; os pacotes npm e de plugin não contêm servidor MCP local ou mecanismos privados. A versão 0.1.1 do Registro rastreia metadados do serviço hospedado independentemente do npm e da versão 0.3.4 do plugin.

Os scripts normais de salvamento e publicação do produto não publicam npm, o repositório público de integração ou o Registro MCP. O npm run release:agent-plugin -- --output <directory> do checkout privado prepara artefatos sanitizados; o npm run check:agent-release -- --release-dir <directory> os verifica. Publique apenas os arquivos public-source gerados no repositório público existente, preservando as configurações de clientes revisadas. Valide o public-source/server.json com o mcp-publisher validate e publique-o com o mcp-publisher publish sob a identidade existente do Registro, verificando os metadados mais recentes. As versões do Registro são imutáveis, portanto alterações nos metadados do Registro exigem uma nova versão do Registro, independentemente das versões do pacote npm.

Para o npm versão 0.3.4, execute o npm pack --ignore-scripts --pack-destination .. a partir do <directory>/public-source. A partir do checkout privado, verifique o arquivo resultante com o npm run check:agent-release -- --release-dir <directory> --npm-tarball <directory>/easygerber-agent-plugin-0.3.4.tgz. Publique exatamente esse arquivo verificado com o npm publish <directory>/easygerber-agent-plugin-0.3.4.tgz --access public.

O pacote contém o runtime do instalador, metadados de conexão, habilidades e ativos. O repositório público também contém um fluxo de trabalho do GitHub Actions e um teste de fumaça do instalador. Em pushes e pull requests, o fluxo de trabalho verifica o instalador empacotado em Linux, Windows e macOS com Node.js 22 e 24. Ele testa perfis de usuário temporários sem conectar-se ao EasyGerber ou usar credenciais de conta. Essas verificações cobrem o comportamento de instalação; elas não certificam autenticação ou operações de placa em um cliente de agente específico. Consulte os resultados do Actions para o status real da execução.

O serviço de produção suporta criação de convidados, layout, visualizações, verificações de bloqueio, ambas as exportações e salvamento de conta. Valide essas operações e a continuação do login com o pacote e o cliente exatos que estão sendo lançados; verificações anteriores de serviço ou pacote não estabelecem aceitação de um novo artefato de cliente.

O fluxo de trabalho e o teste de fumaça são excluídos do pacote npm e dos ZIPs de plugin. A suíte de regressão mais ampla e as ferramentas de lançamento permanecem no checkout de desenvolvimento privado do EasyGerber. Essas ferramentas criam o ZIP do OpenAI, o ZIP do Claude e a fonte pública a partir de listas de permissão de arquivos explícitas e verificam o conteúdo dos arquivos resultantes. A fonte pública inclui uma pasta claude gerada: envie esse caminho de plugin no repositório existente. O Claude exige a pasta separada porque o instalador npm raiz tem um diretório bin/ que o Claude chat e o Cowork não podem instalar. Habilidades e artefatos compartilhados são copiados de suas fontes canônicas durante o lançamento; os mantenedores não editam uma segunda cópia. O runtime do instalador exportado usa apenas os módulos internos do Node.js e o parser público smol-toml; ele nunca importa os pacotes privados do EasyGerber. O pacote do Claude contém apenas documentação, artefatos e metadados de conexão remota.

O mesmo lançamento também gera o .cursor-plugin/plugin.json raiz a partir de metadados compartilhados. Sua conexão MCP inline seleciona a entrada de conta sem alterar as configurações de autenticação raiz do OpenAI. O Cursor usa a habilidade e os ativos raiz existentes; não há cópia separada para manter. O manifesto do Cursor está incluído apenas no repositório público, fora do pacote npm e dos ZIPs do OpenAI/Claude. Envie a URL do repositório público para revisão do Cursor.

O Antigravity usa o .antigravity-plugin/plugin.json gerado e o mcp_config.json raiz com a mesma habilidade e artefatos raiz. Esses dois arquivos estão incluídos apenas no repositório público, fora do pacote npm e dos ZIPs do OpenAI/Claude. O manifesto raiz do OpenAI e as configurações dos outros clientes permanecem inalterados.

O Kiro usa a pasta kiro gerada com oito arquivos, com manifestos padrão de Agent Plugins e o endpoint compatível com convidados. Sua habilidade inclui o fluxo de trabalho canônico completo inline porque referências relativas de fluxo de trabalho não foram resolvidas na sessão nativa testada. A referência independente permanece inalterada. A pasta do Kiro é apenas do repositório e não adiciona arquivos ao pacote npm ou aos ZIPs do OpenAI/Claude; envie a URL pública da pasta para revisão do Kiro.

Antes de publicar, confirme a propriedade do escopo npm, do repositório oficial público de integração e das identidades de publicação do fornecedor. Verifique o login de produção e um fluxo completo de criar/revisar/gerar/exportar nos clientes suportados. Inspecione o npm pack --dry-run --json da exportação pública. Publique apenas esse pacote/repositório sanitizado; o monorepo do produto e seu histórico permanecem privados. Ícones e textos de listagem neste pacote são materiais de lançamento editáveis, não evidência de aprovação de mercado. Não adicione hooks de ciclo de vida de instalação do npm.

A licença MIT cobre este pacote de integração, não o serviço hospedado ou os mecanismos privados.