Capawesome MCP
O servidor MCP Capawesome conecta seu assistente de IA ao Capawesome — a documentação e o blog, e seus aplicativos, builds, implantações e dispositivos do Capawesome Cloud.
Documentação
Servidor MCP
O servidor MCP da Capawesome conecta seu assistente de IA à Capawesome — a documentação e o blog, e seus aplicativos, builds, deploys e dispositivos do Capawesome Cloud. Ele implementa o Model Context Protocol{:target="_blank"}, então funciona com Claude Code, Claude Desktop, Cursor, VS Code e qualquer outro cliente MCP.
Ele é hospedado por nós — não há nada para instalar e nada para manter atualizado:
https://mcp.capawesome.io/mcp
Por si só, o servidor expõe a busca na documentação, para que seu assistente responda com base na documentação atual em vez de dados de treinamento desatualizados. Adicione seu token de API e ative as ferramentas do Cloud, e ele também expõe a superfície de gerenciamento do Capawesome Cloud: acione um build de aplicativo, envie uma atualização ao vivo, reverta um canal ou diagnostique um job com falha — sem sair da conversa.
Autenticação
As ferramentas de documentação funcionam sem autenticação. Todo o resto exige um token de API, enviado como token de portador no cabeçalho Authorization. Crie um no Capawesome Cloud Console{:target="_blank"} — o token é exibido apenas uma vez, então copie-o imediatamente.
Um token age em nome da conta que o criou, então o servidor pode fazer tudo o que você pode fazer em suas organizações e aplicativos. As solicitações passam pela mesma Cloud API que a CLI, o que significa que as mesmas permissões, restrições de rede e limites de taxa se aplicam.
!!! warning "Mantenha os tokens em segredo"
Nunca envie um token para o controle de versão. Armazene-o em um gerenciador de segredos ou em uma variável de ambiente e revogue-o no Console se houver risco de vazamento.
Configuração
Configuração Assistida por IA (Recomendada)
A maneira mais rápida de conectar o servidor é com um assistente de codificação por IA. Primeiro, adicione as habilidades da Capawesome{:target="_blank"} ao seu projeto:
npx skills add capawesome-team/skills --skill capawesome-mcp
Em seguida, use o seguinte prompt na sua ferramenta de IA preferida (por exemplo, Claude Code{:target="_blank"}, Cursor{:target="_blank"} ou GitHub Copilot{:target="_blank"}):
Use the `capawesome-mcp` skill from `capawesome-team/skills` to help me set up the Capawesome MCP server in my project.
O assistente escolherá os conjuntos de ferramentas que você precisa, orientará você na criação de um token de API, escreverá a configuração para o seu cliente MCP e verificará se as ferramentas estão disponíveis.
Configuração Manual
Se preferir configurar manualmente, adicione o servidor ao seu cliente MCP e reinicie-o. Os exemplos usam ?toolsets=all, que registra as ferramentas de documentação mais — assim que você adicionar um token — as ferramentas do Capawesome Cloud. Substitua YOUR_TOKEN pelo seu token de API ou remova o cabeçalho Authorization para usar apenas as ferramentas de documentação.
=== "Claude Code"
Execute o seguinte comando no seu projeto:
```bash
claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" \
--header "Authorization: Bearer YOUR_TOKEN"
```
Adicione `--scope user` para disponibilizar o servidor em todos os projetos, em vez de apenas no atual.
=== "Claude Desktop"
O arquivo de configuração do Claude Desktop só inicia comandos locais, então use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote){:target="_blank"} para acessar o servidor. Adicione o seguinte ao seu `claude_desktop_config.json` (abra-o via **Configurações → Desenvolvedor → Editar Configuração**):
```json
{
"mcpServers": {
"capawesome": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.capawesome.io/mcp?toolsets=all",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}
```
O valor do cabeçalho vem de `env` porque um cabeçalho com espaços não é passado de forma confiável pela linha de comando.
=== "Cursor"
Adicione o seguinte ao `.cursor/mcp.json` no seu projeto, ou ao `~/.cursor/mcp.json` para usar o servidor em todos os lugares:
```json
{
"mcpServers": {
"capawesome": {
"url": "https://mcp.capawesome.io/mcp?toolsets=all",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
```
=== "VS Code"
Adicione o seguinte ao `.vscode/mcp.json` no seu projeto:
```json
{
"servers": {
"capawesome": {
"type": "http",
"url": "https://mcp.capawesome.io/mcp?toolsets=all",
"headers": {
"Authorization": "Bearer ${input:capawesome-token}"
}
}
},
"inputs": [
{
"id": "capawesome-token",
"type": "promptString",
"description": "Capawesome Cloud API token",
"password": true
}
]
}
```
O VS Code solicita o token na primeira vez que o servidor inicia e o armazena com segurança, então o arquivo pode ser commitado com segurança.
Depois de conectado, pergunte ao seu assistente algo como "Quais canais meu aplicativo tem?" ou "Por que meu último build de iOS falhou?" para verificar se as ferramentas estão disponíveis.
Conjuntos de ferramentas
Por padrão, o servidor registra apenas o conjunto de ferramentas público docs — busca na documentação e no blog, sem necessidade de token. Para adicionar o gerenciamento do Capawesome Cloud, use ?toolsets=all, que registra as ferramentas de documentação junto com todos os conjuntos de ferramentas do Cloud:
https://mcp.capawesome.io/mcp?toolsets=all
Isso é o que a maioria das configurações deseja — busca na documentação mais toda a superfície do Cloud. Se você não precisa da busca na documentação, ?toolsets=cloud registra os conjuntos de ferramentas do Cloud sozinhos.
Para registrar um conjunto menor e mais preciso — cada ferramenta ocupa contexto no seu assistente, e menos ferramentas fazem com que ele escolha a certa com mais frequência — nomeie os conjuntos de ferramentas específicos que você precisa, mantendo docs para a busca na documentação:
https://mcp.capawesome.io/mcp?toolsets=docs,cloud-apps,cloud-app-builds,cloud-app-deployments
Coloque a URL entre aspas ao passar parâmetros de consulta na linha de comando; caso contrário, seu shell os interpretará.
Adicione ?readonly=true para registrar apenas ferramentas somente leitura. Nada pode ser criado, alterado ou excluído — uma boa opção para configurações compartilhadas ou não supervisionadas.
Documentação
Registrado por padrão. Não requer token.
| Conjunto de ferramentas | Ferramentas | Descrição |
|---|---|---|
docs | 3 | Pesquise na documentação e no blog. |
Cloud
Opt-in com ?toolsets=cloud (todos) ou por nome. Cada um requer um token de API. Um conjunto de ferramentas chamado cloud-app-* atua em um único aplicativo, então todas as suas ferramentas recebem um ID de aplicativo.
| Conjunto de ferramentas | Ferramentas | Descrição |
|---|---|---|
cloud-app-automations | 5 | Gerencie automações que são acionadas por eventos do Git. |
cloud-app-builds | 5 | Acione builds de aplicativos e compartilhe-os. |
cloud-app-certificates | 5 | Gerencie certificados de assinatura e perfis de provisionamento. |
cloud-app-channels | 5 | Gerencie canais de atualização ao vivo. |
cloud-app-configurations | 5 | Gerencie configurações nativas. |
cloud-app-deployments | 4 | Implante builds em canais e lojas de aplicativos e reverta. |
cloud-app-destinations | 5 | Gerencie destinos de lojas de aplicativos. |
cloud-app-devices | 5 | Inspecione dispositivos e controle qual atualização eles recebem. |
cloud-app-environments | 5 | Gerencie ambientes de build, variáveis e segredos. |
cloud-app-repository | 3 | Vincule um aplicativo a um repositório Git e veja qual ele usa. |
cloud-apps | 4 | Crie, liste e atualize aplicativos. |
cloud-git | 6 | Gerencie as conexões Git de uma organização e navegue pelos repositórios. |
cloud-jobs | 4 | Acompanhe, cancele e diagnostique builds e deploys. |
cloud-license-keys | 6 | Gerencie chaves de licença para SDKs Insiders e Enterprise. |
cloud-organizations | 10 | Identifique-se, liste suas organizações (e os IDs que outras ferramentas precisam) e gerencie membros e convites. |
cloud-teams | 5 | Gerencie equipes e seus aplicativos e membros. |
Referência de ferramentas
Todas as 85 ferramentas, agrupadas por conjunto de ferramentas. Cada uma carrega anotações MCP que a marcam como somente leitura ou destrutiva, que é o que os clientes usam para decidir quando pedir sua confirmação antes de executar uma ferramenta.
docs
| Ferramenta | Descrição |
|---|---|
search_docs | Pesquise na documentação e no blog da Capawesome. |
get_doc_page | Busque uma página de documentação ou blog como Markdown. |
list_blog_posts | Liste as postagens de blog mais recentes. |
cloud-app-automations
| Ferramenta | Descrição |
|---|---|
cloud_list_app_automations | Liste as automações de um aplicativo. |
cloud_get_app_automation | Obtenha uma única automação. |
cloud_create_app_automation | Crie uma automação. |
cloud_update_app_automation | Atualize uma automação. |
cloud_delete_app_automation | Exclua uma automação. |
cloud-app-builds
| Ferramenta | Descrição |
|---|---|
cloud_list_app_builds | Liste builds, filtrados por plataforma ou número do build. |
cloud_get_app_build | Obtenha um build com o status do job e links de download de artefatos. |
cloud_create_app_build | Inicie um build a partir de uma ref do Git ou URL de ZIP. |
cloud_create_app_build_share | Crie um link de compartilhamento com QR code para um build. |
cloud_delete_app_build_share | Revogue um link de compartilhamento imediatamente. |
cloud-app-certificates
| Ferramenta | Descrição |
|---|---|
cloud_list_app_certificates | Liste os certificados de assinatura de um aplicativo, incluindo a expiração. |
cloud_get_app_certificate | Obtenha um único certificado. |
cloud_create_app_certificate | Envie um certificado de assinatura e perfis de provisionamento opcionais. |
cloud_update_app_certificate | Atualize o nome, as senhas ou o tipo de um certificado. |
cloud_delete_app_certificate | Exclua um certificado. |
cloud-app-channels
| Ferramenta | Descrição |
|---|---|
cloud_list_app_channels | Liste os canais de um aplicativo. |
cloud_get_app_channel | Obtenha um único canal. |
cloud_create_app_channel | Crie um canal. |
cloud_update_app_channel | Renomeie, pause ou retome um canal. |
cloud_delete_app_channel | Exclua um canal. |
cloud-app-configurations
| Ferramenta | Descrição |
|---|---|
cloud_list_app_configurations | Liste as configurações nativas de um aplicativo. |
cloud_get_app_configuration | Obtenha uma única configuração nativa. |
cloud_create_app_configuration | Crie uma configuração nativa. |
cloud_update_app_configuration | Atualize o nome de exibição, o nome ou o nome do pacote de uma configuração nativa. |
cloud_delete_app_configuration | Exclua uma configuração nativa. |
cloud-app-deployments
| Ferramenta | Descrição |
|---|---|
cloud_list_app_deployments | Liste deploys, filtrados por build, canal ou destino. |
cloud_get_app_deployment | Obtenha um deploy com o status do job. |
cloud_create_app_deployment | Implante um build em um canal ou destino de loja de aplicativos. Implantar um build anterior é como você reverte. |
cloud_update_app_deployment | Ajuste a porcentagem de distribuição de um deploy. |
cloud-app-destinations
| Ferramenta | Descrição |
|---|---|
cloud_list_app_destinations | Liste os destinos de lojas de aplicativos de um aplicativo. |
cloud_get_app_destination | Obtenha um único destino. |
cloud_create_app_destination | Conecte um destino do App Store Connect ou Google Play. |
cloud_update_app_destination | Atualize um destino, como a faixa do Google Play ou o status de lançamento. |
cloud_delete_app_destination | Exclua um destino. |
cloud-app-devices
| Ferramenta | Descrição |
|---|---|
cloud_list_app_devices | Liste os dispositivos registrados para um aplicativo. |
cloud_get_app_device | Obtenha um único dispositivo. |
cloud_probe_app_device | Verifique qual atualização ao vivo um dispositivo receberia agora. |
cloud_update_app_device | Atribua ou limpe o canal ao qual um dispositivo está fixado. |
cloud_delete_app_device | Exclua um dispositivo. Ele se registra novamente na próxima sincronização. |
cloud-app-environments
| Ferramenta | Descrição |
|---|---|
cloud_list_app_environments | Liste os ambientes de um aplicativo. |
cloud_get_app_environment | Obtenha um único ambiente. |
cloud_create_app_environment | Crie um ambiente. |
cloud_update_app_environment | Renomeie um ambiente e defina ou remova suas variáveis e segredos. |
cloud_delete_app_environment | Exclua um ambiente. |
cloud-app-repository
| Ferramenta | Descrição |
|---|---|
cloud_get_app_repository | Mostre a qual repositório um aplicativo está vinculado. |
cloud_set_app_repository | Vincule um aplicativo a um repositório. |
cloud_delete_app_repository | Desvincule um aplicativo do seu repositório. |
cloud-apps
| Ferramenta | Descrição |
|---|---|
cloud_create_app | Crie um aplicativo em uma organização. |
cloud_list_apps | Liste os aplicativos de uma organização. |
cloud_get_app | Obtenha um único aplicativo. |
cloud_update_app | Atualize um aplicativo. |
cloud-git
| Ferramenta | Descrição |
|---|---|
cloud_list_git_connections | Liste as conexões Git de uma organização. |
cloud_get_git_connection | Obtenha uma única conexão Git. |
cloud_create_git_connection | Crie uma conexão Git por token ou HTTP(S). |
cloud_update_git_connection | Atualize uma conexão Git. |
cloud_delete_git_connection | Exclua uma conexão Git. |
cloud_list_git_repositories | Navegue pelos repositórios disponíveis por meio de uma conexão. |
cloud-jobs
| Ferramenta | Descrição |
|---|---|
cloud_list_jobs | Liste os jobs de uma organização, filtrados por status. |
cloud_get_job | Obtenha um único job. |
cloud_cancel_job | Cancele um build ou deploy em execução. |
cloud_diagnose_job | Busque o final do log e um resumo de falha por IA para um job. |
cloud-license-keys
| Ferramenta | Descrição |
|---|---|
cloud_list_license_keys | Lista as chaves de licença de uma organização. |
cloud_get_license_key | Obtém uma única chave de licença. |
cloud_create_license_key | Cria uma chave de licença e atribui pacotes a ela. |
cloud_update_license_key | Atualiza uma chave de licença. |
cloud_rotate_license_key | Rotaciona uma chave de licença. A chave antiga para de funcionar imediatamente. |
cloud_delete_license_key | Exclui uma chave de licença. |
cloud-organizations
| Ferramenta | Descrição |
|---|---|
cloud_get_current_user | Mostra a qual conta o token pertence. |
cloud_list_organizations | Lista as organizações às quais você tem acesso. |
cloud_get_organization | Obtém uma única organização. |
cloud_create_organization | Cria uma organização, opcionalmente com um código de teste. |
cloud_update_organization | Atualiza uma organização. |
cloud_list_members | Lista os membros de uma organização. |
cloud_delete_member | Remove um membro de uma organização. |
cloud_list_invitations | Lista os convites pendentes de uma organização. |
cloud_create_invitation | Convida alguém para uma organização com um determinado papel. |
cloud_delete_invitation | Revoga um convite pendente. |
cloud-teams
| Ferramenta | Descrição |
|---|---|
cloud_list_teams | Lista as equipes de uma organização. |
cloud_get_team | Obtém uma equipe com seus aplicativos e membros. |
cloud_create_team | Cria uma equipe. |
cloud_update_team | Renomeia uma equipe e adiciona ou remove aplicativos e membros. |
cloud_delete_team | Exclui uma equipe. |
Trabalhando com segredos
Algumas ferramentas aceitam valores sensíveis — segredos de ambiente, certificados de assinatura e credenciais de loja de aplicativos. Qualquer coisa que você passar para uma ferramenta se torna parte da conversa e é enviada ao seu provedor de IA, e pode acabar no histórico do chat ou em logs que você não controla.
!!! warning "Use a CLI para segredos de produção"
Defina segredos de produção, envie certificados de assinatura e conecte destinos de loja com a [CLI](../cloud/cli/index.md) ou o [Console](https://console.cloud.capawesome.io){:target="_blank"} em vez disso. Mantenha o servidor MCP para leitura e para valores com os quais você se sentiria confortável vendo em uma transcrição.
Próximos passos
- LLMs —
llms.txtarquivos e endpoints Markdown que tornam a documentação legível por qualquer modelo. - Skills — habilidades de agente sob demanda que automatizam migrações e configuração da nuvem.
- Editor Rules — regras de projeto sempre ativas que mantêm o código gerado consistente.