Grovs

Servidor MCP para gerenciar deep links, análises e configuração de aplicativos no Grovs.
Funciona com Claude Code, Cursor, Windsurf e qualquer cliente compatível com MCP.

Site · Documentação · Issues

---

O que é o Grovs?

Grovs é uma plataforma de crescimento open-source e focada em privacidade para aplicativos móveis — uma alternativa auto-hospedável ao Branch.io e AppsFlyer. Ela oferece:

• Deep Linking — um link que direciona usuários ao conteúdo certo em iOS, Android e web. Deep links adiados sobrevivem ao fluxo de instalação para que os usuários cheguem à tela certa na primeira abertura.
• Atribuição — atribuição determinística de instalações e eventos em primeira mão. Sem fingerprinting, sem compartilhamento de dados com redes de anúncios.
• Análise de Receita — compras no app, assinaturas e eventos de receita personalizados vinculados à campanha que gerou a instalação.
• Campanhas — agrupe links, acompanhe o desempenho e compare resultados entre canais.

Hospedado na UE, SDKs open-source, mais de 20 milhões de usuários ativos diários em produção. Veja o repositório do backend para auto-hospedagem.

O que é este servidor MCP?

Este é um servidor MCP (Model Context Protocol) que permite que assistentes de IA gerenciem sua plataforma Grovs por meio de linguagem natural. Crie deep links, consulte análises, configure redirecionamentos, execute campanhas — sem sair do seu editor.

Início Rápido

Claude Code

/plugin marketplace add grovs-io/mcp
/plugin install grovs@grovs

Instala o servidor MCP e as skills que ensinam o Claude a usar o Grovs. No primeiro uso, uma janela do navegador abre para OAuth — nenhuma chave de API é necessária.

Cursor

Abra Configurações > MCP e adicione um novo servidor:

{
  "mcpServers": {
    "grovs": {
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

Windsurf

Adicione ao ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "grovs": {
      "serverUrl": "https://mcp.grovs.io/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Adicione ao seu .vscode/mcp.json:

{
  "servers": {
    "grovs": {
      "type": "http",
      "url": "https://mcp.grovs.io/mcp"
    }
  }
}

ChatGPT Desktop

Abra Configurações > Servidores MCP > Adicionar Servidor e insira:

https://mcp.grovs.io/mcp

Auto-hospedado

Se você estiver executando seu próprio backend Grovs, execute o servidor MCP localmente e aponte seu cliente para ele:

git clone https://github.com/grovs-io/mcp.git
cd mcp
npm install && npm run build
npm start

Ou com Docker:

docker build -t grovs-mcp .
docker run -p 8080:8080 grovs-mcp

Em seguida, use http://localhost:8080/mcp como URL do servidor em qualquer uma das configurações de cliente acima.

Todos os clientes acionarão um fluxo OAuth no primeiro uso — uma janela do navegador abre para autenticar com sua conta Grovs.

Configuração

Variável	Padrão	Descrição
PORT	8080	Porta do servidor
GROVS_API_URL	https://mcp.grovs.io	URL do backend Grovs (substituir para auto-hospedagem)
PUBLIC_URL	http://localhost:8080	URL pública deste servidor MCP (usada para callbacks OAuth)

Copie .env.example para .env para desenvolvimento local.

Ferramentas

Ferramenta	Descrição
get_status	Informações da conta, instâncias, projetos e domínios
get_usage	Métricas de uso e status da assinatura de uma instância
create_project	Crie uma nova instância com projetos de produção e teste
create_link	Crie um deep link com metadados, tags e dados personalizados
get_link	Obtenha detalhes completos de um link por caminho
update_link	Atualize metadados, tags ou redirecionamentos de um link
archive_link	Desative um link (irreversível)
search_links	Pesquise e liste links com paginação e filtros
get_analytics_overview	Métricas de nível de projeto: visualizações, instalações, aberturas, receita
get_link_analytics	Métricas diárias por link
get_top_links	Links de melhor desempenho classificados por visualizações
create_campaign	Crie uma campanha para agrupar links relacionados
list_campaigns	Liste campanhas com métricas agregadas
archive_campaign	Arquive uma campanha e desative seus links
configure_redirects	Defina o comportamento de redirecionamento por plataforma (App Store, Play Store, web)
configure_sdk	Configure as configurações do SDK iOS/Android (bundle ID, team ID, etc.)

Arquitetura

MCP Client (Claude Code, Cursor, etc.)
    │
    │  MCP protocol over HTTP
    ▼
Express app (src/app.ts)
    │
    ├── OAuth flow (/authorize, /callback, /register)
    │
    └── MCP endpoint (/mcp)
            │
            ├── Tool registration (src/server.ts)
            │       Zod schema validation + runWithAuth error boundary
            │
            ├── Handlers (src/tools/handlers.ts)
            │       Business logic, plain functions, throw on error
            │
            ├── Formatters (src/tools/formatters.ts)
            │       Convert API JSON to human-readable text
            │
            └── API client (src/api-client.ts)
                    HTTP calls to Grovs backend

Desenvolvimento

npm run dev          # start with auto-reload
npm run build        # compile TypeScript
npm test             # run tests (186 tests)
npm run test:watch   # run tests in watch mode
npm run lint         # ESLint
npm run format       # Prettier

Veja CONTRIBUTING.md para a estrutura do projeto e diretrizes de PR.

SDKs

Plataforma	Repositório
iOS	grovs-io/grovs-ios
Android	grovs-io/grovs-android
React Native	grovs-io/grovs-react-native
Flutter	grovs-io/grovs-flutter

Licença

MIT