Como Usar os Servidores MCP da ACI.dev

No atual cenário de desenvolvimento em rápida evolução, os servidores do Protocolo de Contexto de Modelo (MCP) surgiram como ferramentas poderosas que conectam assistentes de IA a fontes de dados especializadas. Servidores MCP ACI.dev destacam-se ao oferecer uma solução abrangente que proporciona acesso a várias funções de aplicativos através de uma interface unificada.

A ACI.dev oferece dois tipos distintos de servidores MCP, cada um projetado para atender a diferentes necessidades de desenvolvimento:

Servidor MCP de Aplicativos: Este servidor fornece acesso direto às funções de aplicativos específicos que você selecionar. Diferente da maioria dos servidores MCP que limitam você a um único aplicativo, o Servidor de Aplicativos da ACI.dev permite incluir vários aplicativos em uma única configuração de servidor.

Servidor MCP Unificado: Este servidor inovador adota uma abordagem diferente, fornecendo duas funções meta que podem descobrir e executar qualquer função disponível na plataforma ACI.dev. Essa abordagem dinâmica elimina a necessidade de listar todas as ferramentas previamente.

O poder dos Servidores MCP ACI.dev reside em sua capacidade de:

Acessar múltiplas funções de aplicativos sem precisar alternar entre diferentes servidores MCP
Descobrir ferramentas relevantes dinamicamente com base nas suas necessidades específicas
Executar funções em diferentes aplicativos de forma perfeita
Reduzir o uso da janela de contexto carregando apenas as ferramentas relevantes quando necessário

Para desenvolvedores de API, essas capacidades se traduzem em um fluxo de trabalho mais simplificado, onde assistentes de IA podem acessar e utilizar ferramentas de várias aplicações sem a sobrecarga de gerenciar múltiplas conexões separadas.

💡

Dica Profissional: Embora os Servidores MCP da ACI.dev ofereçam excelente acesso a funções de múltiplos aplicativos, o Servidor MCP Apidog fornece capacidades especializadas para desenvolvimento de APIs. O Servidor MCP Apidog dá aos assistentes de IA acesso direto às suas especificações de API, garantindo que o código gerado corresponda perfeitamente aos seus documentos de design.

botão

Configurando Servidores MCP ACI.dev: Um Guia Passo a Passo

Começar com os Servidores MCP ACI.dev requer alguns passos simples. Esta seção orienta você pelo processo completo de configuração para ambos os tipos de servidores.

Pré-requisitos para Servidores MCP ACI.dev

Antes de começar o processo de configuração, certifique-se de ter:

Uma chave de API ACI.dev (obtida da plataforma de desenvolvimento ACI)
Gerenciador de pacotes UV instalado
Aplicativos configurados e definidos em allowed_apps para seu agente em platform.aci.dev
Conectado suas contas específicas de aplicativos sob o mesmo linked-account-owner-id
Uma IDE que suporte MCP, como:

Claude Desktop
Cursor
VS Code com extensões apropriadas

Instalando o Gerenciador de Pacotes UV

Primeiro, instale o gerenciador de pacotes UV, caso ainda não o tenha feito:

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

Configurando o Servidor MCP de Aplicativos

O Servidor MCP de Aplicativos fornece acesso direto às funções de aplicativos específicos que você selecionar:

Escolha Seus Aplicativos

Identifique quais aplicativos você deseja acessar. Você pode encontrar aplicativos disponíveis em platform.aci.dev/apps.

Execute o Servidor

uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Substitua <LINKED_ACCOUNT_OWNER_ID> pelo seu ID de conta da platform.aci.dev.

Configure Sua IDE

Para o Claude Desktop, adicione isso ao seu claude_desktop_config.json:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Para o Cursor, adicione ao seu mcp.json:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Configurando o Servidor MCP Unificado

O Servidor MCP Unificado fornece uma abordagem mais dinâmica com duas funções meta:

ACI_SEARCH_FUNCTIONS_WITH_INTENT - Descobre funções com base na sua intenção/necessidades
ACI_EXECUTE_FUNCTION - Executa qualquer função descoberta pela busca

Execute o Servidor

uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

Configure Sua IDE

Para o Claude Desktop, adicione isso ao seu claude_desktop_config.json:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Para o Cursor, adicione ao seu mcp.json:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Verificando Sua Configuração

Para verificar se sua configuração está funcionando corretamente:

Para o Servidor de Aplicativos: Peça ao seu assistente de IA para usar uma função de um dos seus aplicativos especificados:

"Pesquise por notícias recentes sobre desenvolvimento de API usando a Brave Search"

Para o Servidor Unificado: Peça ao seu assistente de IA para descobrir e usar uma função:

"Preciso encontrar informações sobre as melhores práticas de API REST"

A IA deve responder utilizando diretamente a função especificada (Servidor de Aplicativos) ou, primeiro, descobrindo e, em seguida, executando a função apropriada (Servidor Unificado).

Use o Servidor MCP Apidog para Desenvolvimento de APIs

Enquanto os Servidores MCP ACI.dev se destacam em fornecer acesso a várias funções de aplicativos, o desenvolvimento de APIs muitas vezes requer ferramentas projetadas especificamente para trabalhar com especificações e implementações de API. É aqui que o Servidor MCP Apidog entra em foco, oferecendo capacidades construídas intencionalmente para fluxos de trabalho de desenvolvimento orientados a API que complementam a funcionalidade de propósito geral dos servidores ACI.dev.

Aperfeiçoando o Desenvolvimento de API com o Servidor MCP Apidog

O Servidor MCP Apidog representa um avanço significativo na metodologia de desenvolvimento de API, focando especificamente em tornar as especificações de API diretamente acessíveis aos assistentes de IA. Diferente dos servidores MCP de propósito geral, o Servidor MCP Apidog foi projetado especificamente para o desenvolvimento de APIs, garantindo uma perfeita alinhança entre especificações e implementações.

Como o Servidor MCP Apidog Funciona

Uma vez configurado, o Servidor MCP Apidog lê e armazena em cache automaticamente os dados de especificação de API em sua máquina local. Isso permite que assistentes de IA recuperem e utilizem esses dados sem complicações durante o desenvolvimento. O processo funciona da seguinte maneira:

Conectando-se às Especificações de API: O Servidor MCP Apidog se conecta diretamente às suas especificações de API, sejam elas em projetos Apidog, documentação publicada ou arquivos OpenAPI
Armazenando Dados em Cache Locamente: As especificações são armazenadas em cache para acesso rápido
Fornecendo Contexto à IA: Quando você pergunta à IA sobre sua API, ela pode acessar as especificações exatas
Habilitando Geração de Código: A IA pode gerar código que corresponde perfeitamente ao seu design de API

Essa abordagem especializada garante que todo o desenvolvimento assistido por IA permaneça perfeitamente alinhado com suas especificações de API, eliminando a desconexão comum entre design e implementação.

Configurando o Servidor MCP Apidog

Configurar o Servidor MCP Apidog requer alguns passos simples:

Pré-requisitos:

Node.js (versão 18 ou superior)
Uma IDE que suporte MCP (Cursor, VS Code + plugin Cline)

Escolha Sua Fonte de Dados: O Servidor MCP Apidog suporta três fontes de dados diferentes:

Projeto Apidog: Para acessar especificações de API dentro da sua equipe
Documentação de API Online: Para ler a documentação de API publicada através do Apidog
Arquivos OpenAPI: Para trabalhar com arquivos Swagger/OpenAPI locais ou online

Configure MCP na Sua IDE: Para o Projeto Apidog como fonte de dados (exemplo para Windows):

{
 "mcpServers": {
   "Especificação de API": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

configurando o Servidor MCP Apidog no Cursor

Verifique a Configuração: Teste pedindo ao seu assistente de IA:

"Por favor, busque a especificação da API via MCP e me diga quantos endpoints existem no projeto"

Fluxos de Trabalho Poderosos de Desenvolvimento de API com Apidog MCP

O Servidor MCP Apidog possibilita fluxos de trabalho especializados que transformam o desenvolvimento de APIs:

Geração de Código Baseada em Especificações

"Use o MCP para buscar a especificação da API e gerar registros Java para o esquema 'Product' e esquemas relacionados"

Atualizando Implementações Quando as Especificações Mudam

"Com base na especificação da API, adicione os novos campos ao DTO 'Product'"

Adicionando Documentação ao Código

"Adicione comentários para cada campo na classe 'Product' com base na especificação da API"

Criando Implementações Completas de API

"Gere todo o código MVC relacionado ao endpoint '/users' de acordo com a especificação da API"

Conclusão: Escolhendo o Servidor MCP Certo para Suas Necessidades de Desenvolvimento

O surgimento de servidores MCP especializados marca um avanço significativo no desenvolvimento assistido por IA. Os Servidores MCP ACI.dev se destacam em fornecer acesso a funções de múltiplos aplicativos, enquanto o Servidor MCP Apidog foca especificamente no desenvolvimento de APIs, garantindo uma perfeita alinhância entre especificações e implementações.

Para desenvolvedores, essas ferramentas servem a propósitos complementares:

Servidores MCP ACI.dev: Ideais quando você precisa acessar funções de múltiplos aplicativos ou deseja descoberta dinâmica de funções com base nas suas necessidades específicas.
Servidor MCP Apidog: Perfeito ao implementar APIs e garantir que o código esteja perfeitamente alinhado com as especificações da API.

Ao incorporar essas ferramentas especializadas em seu fluxo de trabalho com base em suas necessidades específicas, você pode aumentar significativamente a produtividade e a qualidade do código. Esses servidores MCP representam uma mudança fundamental nas práticas de desenvolvimento—tornando o trabalho mais eficiente, preciso e, em última análise, mais agradável.