AppsAI MCP Server

Servidor MCP AppsAI

Crie e implante aplicações full-stack com IA. Este servidor MCP conecta o Claude Code, Cursor, Windsurf e outras ferramentas de IA aos seus projetos AppsAI.

Stacks suportadas:

• Frontend: Next.js com React, Tailwind CSS e shadcn/ui
• Backend: Parse Server, Express, Fastify, Hono, Supabase Edge Functions, Firebase Cloud Functions, Serverless Framework ou personalizado
• Banco de dados: MongoDB Atlas (gerenciado)
• Infraestrutura: AWS (S3, CloudFormation, EC2, Lambda e mais)

Instalação

Claude Code

claude mcp add appsai -e APPSAI_API_KEY=your_key -- npx -y @appsai/mcp-server

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "appsai": {
      "command": "npx",
      "args": ["-y", "@appsai/mcp-server"],
      "env": {
        "APPSAI_API_KEY": "your_key"
      }
    }
  }
}

Cursor / Windsurf

Adicione às configurações MCP com:

• Comando: npx -y @appsai/mcp-server
• Ambiente: APPSAI_API_KEY=your_key

Obtendo Sua Chave de API

Para Humanos

1. Cadastre-se em appsai.com
2. Vá para Configurações > Faturamento > Chaves de API
3. Clique em Criar Chave de API
4. Copie a chave (exibida apenas uma vez)

Para Agentes de IA (Registro Autônomo)

Agentes de IA podem se registrar e obter chaves de API programaticamente usando autenticação baseada em carteira:

import requests
from eth_account import Account
from eth_account.messages import encode_defunct

# Agent's wallet
private_key = "0x..."
account = Account.from_key(private_key)

BASE_URL = "https://internal.appsai.com/server/functions"
HEADERS = {"Content-Type": "application/json", "X-Parse-Application-Id": "appsai"}

# 1. Get nonce
nonce_data = requests.post(f"{BASE_URL}/getAgentAuthNonce", headers=HEADERS, json={}).json()["result"]

# 2. Sign the message
signed = account.sign_message(encode_defunct(text=nonce_data["message"]))

# 3. Register and get API key
result = requests.post(f"{BASE_URL}/registerAgentWallet", headers=HEADERS, json={
    "walletAddress": account.address,
    "signature": signed.signature.hex(),
    "nonce": nonce_data["nonce"]
}).json()["result"]

api_key = result["apiKey"]  # Use this with MCP

Adicionando Créditos via Cripto

Agentes podem pagar por créditos usando USDC nas chains suportadas (Ethereum, Base, Arbitrum, Polygon):

# 1. Get payment info
info = requests.post(f"{BASE_URL}/getCryptoPaymentInfo", headers=HEADERS, json={}).json()["result"]
receiving_wallet = info["receivingWallet"]

# 2. Send USDC to receiving_wallet (via your preferred method)

# 3. Verify transaction and add credits
result = requests.post(f"{BASE_URL}/addFundsCrypto", headers=HEADERS, json={
    "walletAddress": account.address,
    "txHash": "0xYOUR_TX_HASH",
    "chainId": 8453  # Base
}).json()["result"]

print(f"Credits added: {result['creditsAdded']}")

Para documentação detalhada da API, veja Documentação da API para Agentes.

Ferramentas (Mais de 150 no Total)

Ferramentas Principais de Desenvolvimento

Categoria	Ferramentas	Descrição
Projeto	5	Criar, listar e gerenciar projetos
Canvas	25	Editar componentes React, estilos e assets
Backend	18	Código backend, S3, CloudFormation e infraestrutura AWS
Sistema	11	Implantar frontend/backend, conectar apps, gerenciar servidores MCP
MongoDB	18	Gerenciamento de banco de dados e coleções
Agentes	9	Gerenciamento e versionamento de prompts de IA

Ferramentas de Gerenciamento da Plataforma

Categoria	Ferramentas	Descrição
Faturamento	15	Assinatura, créditos, pagamentos, faturas
Marketplace	12	Publicar, navegar e comprar templates
Vendedor	5	Stripe Connect, ganhos, painel do vendedor
Domínio	7	Gerenciamento de subdomínio e domínio personalizado
Equipe	7	Colaboradores, permissões, convites
Transferência	6	Transferências de propriedade de projetos
Configurações	4	Configurações de exibição e metadados do projeto
Chaves de API	3	Gerenciamento de chaves de API da plataforma
Custo	6	Custos AWS, métricas de uso, previsões

Ferramentas de Sistema

Ferramenta	Descrição
system_DEPLOY_BACKEND	Implantar infraestrutura de backend
system_DEPLOY_FRONTEND	Implantar frontend na CDN
system_DEPLOY_ALL	Implantar frontend e backend
system_GET_ENVIRONMENT_STATUS	Obter status e URLs de implantação
system_GET_DEPLOY_ARTIFACTS	Obter artefatos e histórico de implantação
system_CONNECT_APP	Conectar dois projetos para operações entre apps
system_DISCONNECT_APP	Remover conexão entre projetos
system_ADD_MCP_SERVER	Adicionar um servidor MCP externo a um projeto
system_LIST_MCP_SERVERS	Listar servidores MCP configurados
system_UPDATE_MCP_SERVER	Atualizar configuração do servidor MCP
system_REMOVE_MCP_SERVER	Remover um servidor MCP do projeto

Ferramentas de Faturamento

Ferramenta	Descrição
billing_GET_CURRENT_PLAN	Obter detalhes do plano de assinatura
billing_CREATE_CHECKOUT	Iniciar compra de assinatura
billing_GET_PORTAL_SESSION	Abrir portal de faturamento Stripe
billing_ADD_FUNDS	Adicionar créditos à conta
billing_GET_AVAILABLE_CREDITS	Obter saldo atual de créditos
billing_GET_INVOICES	Listar faturas
billing_GET_PAYMENT_METHODS	Listar métodos de pagamento salvos

Ferramentas do Marketplace

Ferramenta	Descrição
marketplace_PUBLISH_TEMPLATE	Publicar projeto no marketplace
marketplace_UNPUBLISH_TEMPLATE	Remover do marketplace
marketplace_GET_TEMPLATES	Navegar pelos templates do marketplace
marketplace_GET_TEMPLATE_DETAILS	Obter informações do template
marketplace_FORK_TEMPLATE	Bifurcar um template
marketplace_GET_MY_PUBLISHED	Templates publicados pelo usuário
marketplace_GET_MY_PURCHASES	Histórico de compras

Ferramentas de Domínio

Ferramenta	Descrição
domain_CHECK_AVAILABILITY	Verificar disponibilidade de subdomínio
domain_UPDATE_SUBDOMAIN	Atualizar subdomínio do projeto
domain_ADD_CUSTOM_DOMAIN	Adicionar domínio personalizado
domain_VERIFY_CUSTOM_DOMAIN	Verificar configuração DNS
domain_REMOVE_CUSTOM_DOMAIN	Remover domínio personalizado

Ferramentas de Equipe

Ferramenta	Descrição
team_GET_COLLABORATORS	Listar colaboradores do projeto
team_INVITE_COLLABORATOR	Convidar usuário para o projeto
team_REMOVE_COLLABORATOR	Remover colaborador
team_UPDATE_PERMISSIONS	Alterar função do colaborador

Exemplo de Uso

"List my apps"
→ project_LIST_APPS

"Create a new Next.js app"
→ project_CREATE_APP

"Show the file tree for project abc123"
→ canvas_LIST_FILES

"Deploy the frontend"
→ system_DEPLOY_FRONTEND

"Add an MCP server to my project"
→ system_ADD_MCP_SERVER

"Check my current plan"
→ billing_GET_CURRENT_PLAN

"Publish my project to the marketplace"
→ marketplace_PUBLISH_TEMPLATE

"Add a custom domain"
→ domain_ADD_CUSTOM_DOMAIN

"Invite [email protected] to my project"
→ team_INVITE_COLLABORATOR

Integração com Servidor MCP

Projetos AppsAI podem se conectar a servidores MCP externos, dando aos seus agentes de IA acesso a ferramentas adicionais:

"Add the Stripe MCP server to my project"
→ system_ADD_MCP_SERVER with serverUrl and serverLabel

"List my configured MCP servers"
→ system_LIST_MCP_SERVERS

"Disable the Stripe MCP server"
→ system_UPDATE_MCP_SERVER with enabled: false

Uma vez configurado, agentes de IA no seu projeto AppsAI podem usar ferramentas dos servidores MCP conectados.

Recursos

O servidor fornece contexto do projeto como recursos MCP:

• appsai://projects - Lista dos seus projetos
• appsai://project/{id} - Detalhes do projeto e estrutura de arquivos

Prompts

Prompts integrados para construir aplicações completas:

• build-youtube - Construir um clone do YouTube com uploads de vídeo e comentários
• build-slack - Construir um clone do Slack com mensagens em tempo real
• build-twitter - Construir um clone do Twitter/X com posts e seguidores
• connect-apps - Conectar dois projetos AppsAI

Requisitos

• Node.js 18+
• Conta AppsAI com créditos
• Chave de API em Configurações > Faturamento

Documentação

• Documentação AppsAI
• Guia de Integração MCP

Suporte

• Issues no GitHub
• Discord

Licença

MIT