Integração de Inteligência Artificial com MCP

O Model Context Protocol (MCP) é uma tecnologia standard desenvolvida pela Anthropic que permite que assistentes de IA (como o Claude Desktop, Cursor, Windsurf ou Antigravity) interajam com ferramentas externas. O Acapadev ID possui um servidor MCP oficial!

O que isto significa?

Isto significa que em vez de teres de abrir o portal do Acapadev ID no browser para consultares os teus logins ou rodares segredos de aplicações OAuth, podes simplesmente pedir à tua Inteligência Artificial (dentro do teu editor de código ou desktop) em linguagem natural:

"Mostra-me o meu histórico de logins recentes."
"Quais são os dispositivos que estão como 'trusted' na minha conta?"
"Cria uma nova OAuth App chamada 'Gestão Financeira' e diz-me qual é o Client ID."

Como Instalar na tua IDE

O servidor MCP oficial chama-se @devkussema/acapadev-mcp e está publicado globalmente no NPM. Para usares, não precisas de instalar código no teu projeto, apenas tens de configurar a tua IDE ou Agente de IA para carregar a ferramenta via npx.

1. Variáveis de Ambiente Necessárias

Antes de configurares a IDE, precisas de gerar um Personal Access Token (PAT) na plataforma do Acapadev ID, caso ainda não tenhas um.

Variável	Descrição	Exemplo
ACAPADEV_API_KEY	O teu Personal Access Token.	3|aBcD...
ACAPADEV_API_URL	O URL base da API do Acapadev.	https://api.acapadev.com

2. Exemplo de Configuração (Cursor / Windsurf / Antigravity)

Vai às definições do MCP (geralmente em Settings > MCP Servers > Add New) e usa a seguinte configuração:

{
  "mcpServers": {
    "Acapadev": {
      "command": "npx",
      "args": [
        "-y",
        "@devkussema/acapadev-mcp"
      ],
      "env": {
        "ACAPADEV_API_KEY": "O_TEU_TOKEN_AQUI",
        "ACAPADEV_API_URL": "https://api.acapadev.com"
      }
    }
  }
}

Ferramentas Disponíveis

Assim que a tua IDE estiver conectada ao Servidor MCP, ela terá acesso transparente às seguintes ferramentas oficiais:

• get_user_profile - Obtém os detalhes completos do teu perfil e definições premium.
• list_my_login_history - Regista a data, IP e browser de todos os teus logins.
• list_trusted_devices - Lista computadores e telemóveis marcados para não pedir 2FA.
• revoke_trusted_device - Apaga remotamente a confiança de um dispositivo.
• list_my_oauth_apps - Obtém todas as Apps OAuth de que és criador.
• get_oauth_app_details - Verifica detalhes técnicos, IDs e rotas permitidas de uma app.
• create_oauth_app - Cria uma aplicação instantaneamente com o nome e URL fornecidos.
• rotate_oauth_client_secret - Cancela um secret comprometido e gera um novo imediatamente.