Digite para filtrar as páginas da documentação.

    Termfy

    MCP

    Consulte o servidor MCP stdio do Termfy e seu catálogo de tools e resources. Veja como registrar funções e testar a conversa do agente pelo protocolo.

    O servidor embutido

    mycli mcp conecta um McpServer ao transporte stdio. A partir daí, stdout pertence ao JSON-RPC e qualquer diagnóstico vai para stderr. O processo só termina quando o cliente fecha o transporte.

    Configuração em um cliente:

    { "mcpServers": { "mycli": { "command": "mycli", "args": ["mcp"] } } }

    No Claude Code: claude mcp add mycli -- mycli mcp. Em desenvolvimento, sem compilar: "command": "bun", "args": ["run", "src/main.ts", "mcp"].

    O que o starter kit expõe

    Tipo Nome Função
    tool doctor { checks, ok } do diagnóstico, sem gravar arquivos
    tool about identidade, runtime, plataforma, pasta de dados, créditos
    tool exit_codes tabela de códigos de saída
    tool skill documentação embutida, inteira ou por tópico
    tool config_list chaves de settings.json em vigor e o esquema
    tool config_get valor de uma chave
    tool credentials_status arquivo, origem da chave mestra, quantidade e nomes
    resource mycli://about identidade em JSON
    resource mycli://exit-codes códigos em JSON
    resource mycli://skill documentação completa
    resource mycli://skill/{topic} uma seção, o template lista os tópicos
    prompt operate instrui o agente a ler skill cli e cumprir uma tarefa pelo CLI com --json

    Nenhuma tool devolve o valor de uma credencial e nenhuma grava. Escrita continua no CLI. A confirmação depende do comando: credentials clear pede confirmação, enquanto config set e credentials rotate-key não.

    mycli mcp --list enumera tudo sem abrir o transporte. O servidor mantém um catálogo durante o registro, então a lista e o que o cliente vê são iguais.

    Regras para tools

    • Nome em snake_case, <grupo>_<acao>.
    • title, description que diz quando usar e o que devolve, inputSchema em Zod com .describe() em cada campo.
    • Para saída estruturada, use content em texto e structuredContent com o mesmo objeto. A tool skill devolve apenas texto Markdown. Falha prevista devolve isError: true com a ação sugerida.
    • Tools que gravam ou chamam rede dizem isso na descrição.
    • Respostas curtas. Paginação por limit e cursor quando a lista cresce.
    • Tools que consomem APIs leem o token com getCredential(name) internamente.

    Economia de tokens

    O OpenMCP, padrão para converter APIs web em servidores MCP, formaliza algo que vale para qualquer servidor: o agente lê todas as descrições de tool a cada conversa, então cada palavra a mais custa em todas as chamadas. O Termfy aplica isso com uma tool de descoberta (skill) em vez de dezenas de tools de documentação, descrições de duas frases e resources para consultar conteúdo sem executar ações.

    Adicionar uma tool

    1. Copie template/tool/example.ts para src/mcp/tools/<grupo>.ts.
    2. Implemente reutilizando funções de src/config/ e coletores do CLI.
    3. Acrescente ao catalog.tools e registre em registerAll (src/mcp/server.ts).
    4. Teste em tests/mcp.test.ts, que sobe o binário e conversa pelo Client do SDK. Para testar à mão, use npx @modelcontextprotocol/inspector bun run src/main.ts mcp.
    5. Atualize a tabela em docs/mcp.md.

    A skill termfy-mcp traz o contrato de tool, o guia de testes e a documentação do SDK e da especificação MCP em references/.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano