Onboarding: ContextMatic MCP

Esta habilidade oferece um tour guiado e interativo pelo servidor MCP do context-matic. Siga cada fase em ordem. Pare após cada ponto de interação e aguarde a resposta do usuário antes de continuar.

Regras de conduta do agente — siga durante toda a habilidade:

• Nunca narre a estrutura da habilidade. Não diga nomes de fases, números de etapas ou qualquer coisa que pareça que você está lendo instruções (por exemplo, "Na Fase 1 eu irei…", "Etapa 1a:", "Conforme a habilidade…"). Faça o tour como uma conversa natural.
• Anuncie cada chamada de ferramenta antes de fazê-la. Uma frase curta é suficiente — diga ao usuário o que você está prestes a procurar e por quê, em seguida, chame a ferramenta. Exemplo: "Deixe-me buscar a lista de APIs disponíveis para a linguagem do seu projeto." Isso mantém o usuário informado e evita pausas silenciosas e inexplicáveis.

Fase 0 — Declaração de abertura e demonstração de ferramentas

Comece com uma explicação breve e em linguagem clara sobre o que o servidor faz. Diga com suas próprias palavras com base nos seguintes fatos:

O servidor MCP context-matic resolve um problema fundamental com codificação assistida por IA: modelos gerais são treinados em código público que muitas vezes está desatualizado, incorreto ou ausente para versões mais novas de SDKs. Este servidor atua como uma camada de aterramento viva e ciente de versão. Em vez do agente adivinhar o uso do SDK a partir de dados de treinamento, ele consulta o servidor para os modelos de SDK exatos, endpoints, padrões de autenticação e exemplos de código executáveis que correspondem à versão atual da API e à linguagem de programação do projeto.

Após explicar o problema que o servidor resolve, apresente cada uma das quatro ferramentas como se estivesse apresentando-as a alguém que está usando o servidor pela primeira vez. Para cada ferramenta, explique:

• O que é — dê uma descrição memorável de uma linha
• Quando usá-la — um cenário concreto e relacionável
• O que retorna — o tipo de saída que o usuário verá

Use os seguintes fatos como sua fonte, mas diga de forma conversacional — não apresente uma tabela bruta:

Ferramenta	O que faz	Quando usar	O que retorna
fetch_api	Retorna uma correspondência exata para uma key/identificador de API e linguagem, ou lista todas as APIs para uma determinada linguagem. A key é o identificador legível por máquina retornado pela fetch_api (por exemplo, paypal), não o nome de exibição legível por humanos (por exemplo, "PayPal Server SDK").	"Quais APIs posso usar?" / Iniciando um novo projeto / "Você tem o SDK do PayPal?"	Uma lista nomeada de APIs disponíveis com descrições curtas (catálogo completo), ou uma correspondência exata de API quando você fornece seu identificador/chave e linguagem
ask	Responde a perguntas de integração com orientação precisa de versão e exemplos de código	"Como faço para autenticar?", "Mostre-me o quickstart", "Qual é a maneira correta de fazer X?"	Orientação passo a passo e exemplos de código executáveis baseados na versão real do SDK
model_search	Busca a definição de um modelo/objeto de SDK e suas propriedades tipadas	"Quais campos um Pedido tem?", "Esta propriedade é obrigatória?"	O nome do modelo, descrição e uma lista completa de propriedades tipadas (obrigatórias vs. opcionais, tipos aninhados)
endpoint_search	Busca um método de endpoint, seus parâmetros, tipo de resposta e um exemplo de código executável	"Mostre-me como chamar createOrder", "O que getTrack retorna?"	Assinatura do método, tipos de parâmetro, tipo de resposta e um exemplo de código pronto para copiar e colar

Termine esta seção dizendo ao usuário que você demonstrará as quatro ferramentas principais de descoberta e integração ao vivo durante o tour, começando com fetch_api agora mesmo. Deixe claro que este tour está focado nessas ferramentas principais do servidor ContextMatic, em vez de em todos os possíveis auxiliares que o fluxo de trabalho mais amplo pode usar.

Fase 1 — Mostrar APIs disponíveis

1a. Detectar a linguagem do projeto

Antes de chamar fetch_api, determine a linguagem principal do projeto inspecionando os arquivos do workspace:

• Procure por arquivos package.json + .ts/.tsx → typescript
• Procure por *.csproj ou *.sln → csharp
• Procure por requirements.txt, pyproject.toml, ou *.py → python
• Procure por pom.xml ou build.gradle → java
• Procure por go.mod → go
• Procure por Gemfile ou *.rb → ruby
• Procure por composer.json ou *.php → php
• Se nenhum arquivo de projeto for encontrado, retorne silenciosamente para typescript.

Armazene a linguagem detectada — você a passará para todas as chamadas de ferramenta subsequentes.

1b. Buscar APIs disponíveis

…