Crie a sua extensão

Tudo o que você vê no marketplace foi publicado por alguém. Pode ser você. O caminho tem cinco trechos: criar → testar → empacotar → publicar → manter, e o aplicativo acompanha você em todos eles.

O caminho completo

1. Criar

   Na galeria de extensões há uma aba de criação. Comece escolhendo o tipo: servidor MCP, habilidade, complemento, agente ou equipe.

   Você não começa de uma página em branco: cada tipo parte de um modelo que já funciona. Sobre ele você preenche nome, descrição, ícone e as credenciais de que a sua extensão vai precisar.

   E o modelo ajuda: descreva com as suas palavras o que você quer que ele faça e ele gera o esqueleto completo, manifesto incluído. Você revisa e ajusta.

2. Testar antes de publicar

   A extensão é instalada localmente e executada ali mesmo. Você vê as suas ferramentas, vê o que ela devolve e vê os seus erros com o texto completo.

   Cuidado

   Não é possível publicar nada que não tenha sido executado pelo menos uma vez. Se o teste falhar, o aplicativo diz por quê — um comando que não existe, uma credencial que falta, um manifesto incompleto — e não deixa seguir até que ela funcione.

3. Empacotar

   Ao empacotar, escreve-se o manifesto: versão, requisitos, plataformas compatíveis, permissões declaradas e nomes das credenciais que pede. Acrescenta-se também o checksum SHA-256 do pacote, para que quem instalar possa conferir que recebe exatamente o que foi publicado.

   Se você empacotar um agente que já tem configurado (a opção de publicar este agente, a partir da ficha dele), o aplicativo remove as suas credenciais: viajam os nomes do que é preciso conectar, nunca os valores. A sua chave de API fica no seu computador.

4. Publicar

   Você se identifica com a sua conta do Context Code — a mesma com que entra no aplicativo; não existe uma conta separada para publicar.

   A entrada fica em revisão até que um administrador a aprove. Aprovada, passa a publicada e aparece na galeria de todo mundo. Se for recusada, volta a rascunho com o motivo escrito, que você lê.

   rascunho ──▶ em revisão ──▶ publicada ──▶ retirada
                    │
                    └──▶ rascunho   (recusada, com o motivo)

5. Atualizar e retirar

   Publicar uma versão nova a devolve à revisão: toda versão é olhada. Você pode retirar a sua extensão quando quiser; ela deixa de ser oferecida para novas instalações.

   Na sua ficha você vê quantas instalações ela acumula. É um contador aproximado, só para dar uma ideia do alcance.

Criar uma extensão: escolhe-se o tipo, parte-se de um modelo que já funciona e o modelo gera o esqueleto.

Criar uma extensão: escolhe-se o tipo, parte-se de um modelo que já funciona e o modelo gera o esqueleto.

O manifesto

O manifesto é o documento que descreve a sua extensão. É o que a galeria lê para desenhar a ficha e o que o aplicativo lê para instalá-la.

Manifesto de um agente

Este agente redige relatórios financeiros. Repare em três coisas: modeloRecomendado é o que o autor considera melhor, alternativas inclui pelo menos uma local ("local": true, com o provedor context-forge) para poder usá-lo sem custo, e em mcp viajam apenas os nomes das credenciais, nunca os seus valores.

{
  "formato": 1,
  "permisos": ["lectura-archivos", "red"],
  "agente": {
    "rol": "Analista de relatórios financeiros",
    "instrucciones": "Leia os dados do trimestre, compare-os com o anterior e redija um relatório com resumo executivo, tabela de números e três conclusões. Nunca invente um número: se faltar um dado, diga.",
    "tono": "Sóbrio e direto, sem adjetivos a mais.",
    "queSabeHacer": [
      "Comparar dois períodos e explicar as variações",
      "Redigir o resumo executivo para a diretoria",
      "Detectar números que não batem e apontá-los"
    ],
    "modeloRecomendado": {
      "proveedor": "anthropic",
      "modelo": "claude-sonnet-4-5",
      "local": false
    },
    "alternativas": [
      { "proveedor": "openai", "modelo": "gpt-5", "local": false },
      { "proveedor": "context-forge", "modelo": "qwen3-27b-instruct", "local": true }
    ],
    "herramientas": ["leer_archivo", "escribir_archivo", "buscar"],
    "permisos": ["lectura-archivos"],
    "habilidades": ["redaccion-informes"],
    "mcp": [
      { "id": "postgres", "credenciales": ["POSTGRES_URL"] },
      { "id": "hoja-calculo", "credenciales": ["SHEETS_TOKEN"] }
    ],
    "planPrevio": true,
    "delegaEnSubagentes": false,
    "limiteGastoSugerido": "2.00",
    "ejemplos": [
      "Prepare o relatório do terceiro trimestre com os dados do banco",
      "Compare as vendas deste mês com o mesmo mês do ano passado",
      "Revise este relatório e diga quais números não batem"
    ]
  }
}

• rol, instrucciones e tono são a identidade do agente: quem ele é e como fala.
• queSabeHacer é a lista mostrada na ficha, para se entender de relance.
• herramientas, permisos, habilidades e mcp são o de que ele precisa para trabalhar. Tudo isso é mostrado ao usuário antes de instalar.
• planPrevio diz se ele propõe um plano antes de agir; delegaEnSubagentes, se abre agentes auxiliares; limiteGastoSugerido, quanto convém deixá-lo gastar por tarefa.
• ejemplos são os pedidos que aparecem na ficha para disparar com um clique.

Manifesto de uma equipe

Uma equipe de redes sociais: um coordenador de campanha distribui o trabalho e cada agente escreve para a sua rede.

{
  "formato": 1,
  "equipo": {
    "coordinador": {
      "nombre": "Coordenador de campanha",
      "rol": "Recebe a mensagem da campanha, decide o que sai em cada rede, distribui o trabalho e confere que tudo conta a mesma história antes de dar o aval."
    },
    "agentes": [
      {
        "id": "redes-instagram",
        "nombre": "Agente de Instagram",
        "rol": "Escreve legendas curtas e visuais, propõe a imagem e escolhe as hashtags."
      },
      {
        "id": "redes-x",
        "nombre": "Agente de X",
        "rol": "Condensa a mensagem em publicações bem curtas e prepara a thread quando algo precisa ser desenvolvido."
      },
      {
        "id": "redes-linkedin",
        "nombre": "Agente de LinkedIn",
        "rol": "Redige em tom profissional, com o porquê do anúncio e uma chamada para ação contida."
      }
    ],
    "repartoTareas": "O coordenador cria uma tarefa por rede a partir da mensagem de campanha, envia ao seu agente, recolhe os rascunhos, verifica que não se contradizem e devolve o pacote pronto para revisão."
  }
}

Nota

Os exemplos são comentados no texto ao redor, não dentro do JSON: o JSON não aceita comentários e um arquivo com // dentro não pode ser instalado.

Regras de publicação

• Identificador em minúsculas e com hifens: redes-instagram, não Redes Instagram nem redes_instagram.
• Um agente deve sempre oferecer uma alternativa de modelo local. Ninguém deveria precisar de uma assinatura só para experimentar o seu agente.
• Nada de subir credenciais. Viajam os nomes do que é preciso conectar; os valores ficam no computador de cada usuário. Um pacote com uma chave dentro é recusado.
• Oficial e Verificada só a equipe do Context Code concede, nunca o autor. Não as coloque no seu manifesto.
• Tudo o que vem de fora passa por revisão antes de ser público. Sem exceções, e a cada versão nova.

Dica

Se você já tem um agente que funciona bem, empacotá-lo leva alguns minutos e serve a muita gente. Publique e ele aparecerá no marketplace de extensões ao lado dos demais.