Protocolo de Contexto do Modelo (MCP)

o protocolo de contexto do modelo (mcp) é um padrão para conectar modelos de linguagem de grande escala (llms) a plataformas como back4app este guia cobre como conectar o back4app às seguintes ferramentas de ia usando o mcp cursor windsurf (codium) visual studio code (copilot) cline (extensão do vs code) claude desktop claude code uma vez conectado, seus assistentes de ia podem interagir e consultar seus projetos do back4app em seu nome agentes de ia com mcp estão configurados para ter acesso total aos seus aplicativos do back4app, o que inclui a capacidade de criar, modificar e excluir recursos recomendamos fortemente tentar primeiro em uma conta e aplicativo de teste para entender suas capacidades e impacto potencial antes de usá lo em ambientes de produção pré requisitos uma conta criada em back4app com (cada nova conta tem um limite padrão de aplicativos, se você precisar de mais, entre em contato conosco); uma versão recente do nodejs instalada (16^); para melhores resultados, recomendamos usar os modelos llm mais avançados e agentes de codificação; ativar web hosting para visualizar implantações em seu subdomínio; 1 criar uma chave de conta primeiro, vá para o seu painel do back4app e crie um token de acesso pessoal faça login na sua conta do back4app passe o mouse sobre o menu "olá, \[nome de usuário]" vá para chaves de conta e crie uma nova chave dê um nome que descreva seu propósito, como "assistente de ia mcp" copie o token com segurança você não poderá vê lo novamente então dê um nome ao seu token de chave de conta e clique em + este token será usado para autenticar o servidor mcp com sua conta back4app 2 instalar mcp auto siga estas etapas para instalar o back4app mcp em seu ide/llm preferido 2 1 execute o comando de instalação execute este comando no seu terminal substituindo \<ide> pelo seu ambiente preferido e your account key pela chave de conta copiada em passo 1 npx @back4app/mcp installer install \<ide> account key your account key os comandos específicos para cada ide estão listados abaixo cursor npx @back4app/mcp installer install cursor account key your account key windsurf npx @back4app/mcp installer install windsurf account key your account key visual studio npx @back4app/mcp installer install vscode account key your account key cline npx @back4app/mcp installer install cline account key your account key 2 2 verificar conexão cursor vá para configurações > configurações do cursor > mcp windsurf encontre a barra de ferramentas acima da entrada cascade e clique em atualizar visual studio clique em configurar ferramentas no modo agente (copilot) e encontre as ferramentas mcp do back4app 3 configure na sua ferramenta de ia manual ferramentas compatíveis com mcp podem se conectar ao back4app usando o servidor mcp do back4app abaixo estão as instruções para se conectar a este servidor usando ferramentas populares de ia cursor abra o cursor e vá para o menu cursor navegue até cursor >configurações >configurações do cursor >mcp clique em +adicionar um novo mcp global em seguida, adicione a seguinte configuração macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } substitua \<account key> pela sua chave de conta copiada do back4app salve o arquivo de configuração configuração alternativa se você preferir uma configuração de projeto, pode criar um arquivo de configuração de projeto local crie um cursor diretório na raiz do seu projeto se ele não existir crie um cursor/mcp json arquivo se ele não existir e abra o adicione a configuração mencionada anteriormente windsurf abra o windsurf e navegue até o assistente cascade toque no ícone do martelo (mcp), depois em configurar para abrir o arquivo de configuração adicione a seguinte configuração macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } substitua \<account key> pela sua chave de conta copiada do back4app salve o arquivo de configuração e recarregue tocando em atualizar no assistente cascade você deve ver um status ativo verde após o servidor ser conectado com sucesso visual studio(copilot) abra o vs code e crie um vscode diretório na raiz do seu projeto se ele não existir crie um vscode/mcp json arquivo se ele não existir e abra o adicione a seguinte configuração macos / linux { "inputs" \[ { "type" "promptstring", "id" "back4app account key", "description" "token de acesso pessoal do back4app", "password" true } ], "servers" { "back4app" { "command" "npx", "args" \[" y", "@back4app/mcp server back4app\@latest"], "env" { "back4app account key" "${input\ back4app account key}" } } } } windows { "inputs" \[ { "type" "promptstring", "id" "back4app account key", "description" "token de acesso pessoal do back4app", "password" true } ], "servers" { "back4app" { "command" "npx cmd", "args" \[" y", "@back4app/mcp server back4app\@latest"], "env" { "back4app account key" "${input\ back4app account key}" } } } } salve o arquivo de configuração abra o chat do copilot e mude para o modo "agente" você deve ver um ícone de ferramenta que pode tocar para confirmar que as ferramentas mcp estão disponíveis uma vez que você comece a usar o servidor, será solicitado que você insira seu token de acesso pessoal insira o token que você criou anteriormente para mais informações sobre como usar o mcp no vs code, consulte a documentação do copilot cline abra a extensão cline no vs code e toque no ícone dos servidores mcp toque em configurar servidores mcp para abrir o arquivo de configuração adicione a seguinte configuração macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } substitua \<account key> pela sua chave de conta copiada do back4app salve o arquivo de configuração o cline deve recarregar automaticamente a configuração você deve ver um status ativo verde após o servidor ser conectado com sucesso claude desktop abra o claude desktop e navegue até configurações na aba desenvolvedor, toque em editar config para abrir o arquivo de configuração adicione a seguinte configuração macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } substitua \<account key> pela sua chave de conta copiada do back4app salve o arquivo de configuração e reinicie o claude desktop na nova tela de chat, você deve ver um ícone de martelo (mcp) aparecer com o novo servidor mcp disponível instalações desatualizadas do node js podem causar a falha do comando npx no claude desktop recomendamos desinstalar quaisquer versões anteriores à 16 e usar o node js v16 ou superior código claude crie um mcp json arquivo na raiz do seu projeto se ele não existir adicione a seguinte configuração macos / linux { "mcpservers" { "back4app" { "command" "npx", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } windows { "mcpservers" { "back4app" { "command" "npx cmd", "args" \[ " y", "@back4app/mcp server back4app\@latest", " account key", "\<account key>" ] } } } substitua \<account key> pela sua chave de conta copiada do back4app salve o arquivo de configuração reinicie o código claude para aplicar a nova configuração instalações desatualizadas do node js podem fazer com que o comando npx falhe no código claude recomendamos desinstalar quaisquer versões anteriores a 16 e usar o node js v16 ou superior 3 ferramentas disponíveis uma vez conectado, seu assistente de ia pode realizar uma ampla gama de tarefas em sua conta back4app aqui estão algumas das ferramentas disponíveis gerenciamento de aplicativos create parse app criar um novo aplicativo parse get parse apps obter uma lista de todos os seus aplicativos parse get parse app obter detalhes de um aplicativo parse específico set current app definir um aplicativo padrão para operações subsequentes get current app obter o aplicativo padrão atualmente definido acesso direto à api (parse rest api) call parse api chama os endpoints da api rest do parse server para gerenciar completamente seu aplicativo operações de banco de dados – criar, ler, atualizar, excluir objetos em qualquer classe – consultas ricas (filtros, ordenação, paginação, contagem, agregação, distinto) gerenciamento de usuários & segurança – inscrição / login / logout / redefinição de senha – funções, acls & clps para restringir dados em nível de objeto e classe tempo real & push – livequery sobre websockets (inscrever se em criações/atualizações/exclusões) – notificações push & registros de instalação chamar funções de cloud code – funções em nuvem e tarefas agendadas – gatilhos antes/depois, webhooks personalizados arquivos, análises & extensões – upload/download de arquivos cloud code e hospedagem web no parse app listar arquivos de cloud code e hospedagem web listar todos os arquivos de cloud code e hospedagem web obter conteudo do arquivo ver o conteúdo de arquivos específicos implantar arquivos de cloud code implantar arquivos de cloud code no seu app implantar arquivos de hospedagem web implantar arquivos de hospedagem web no seu app 4 considerações de segurança o servidor mcp tem acesso total à sua conta back4app com as permissões do seu token de acesso pessoal isso significa que ferramentas de ia podem criar, modificar e sobrescrever seus aplicativos e dados sempre tome as seguintes precauções use uma conta de teste dedicada para experimentação inicial crie um token de acesso separado especificamente para uso do mcp nunca compartilhe seus arquivos de configuração contendo tokens de acesso revise todo o código e chamadas de api gerados ou modificados por ia antes de implantar em produção revogue tokens de acesso imediatamente se suspeitar de qualquer uso não autorizado 5 solução de problemas problemas comuns falhas de conexão certifique se de que seu token de acesso pessoal é válido e está corretamente inserido servidor não respondendo verifique se você tem o node js instalado e se o npx está funcionando corretamente erros de permissão verifique se seu token de acesso tem as permissões necessárias atualizações não aparecendo alguns clientes mcp requerem uma reinicialização após alterações de configuração 6 próximos passos sua ferramenta de ia agora está conectada ao back4app usando mcp tente pedir ao seu assistente de ia para criar um novo aplicativo, implantar algum código em nuvem ou gerenciar seus dados usando linguagem natural se você encontrar algum problema ou tiver feedback, por favor, envie nos uma mensagem para community\@back4app com conclusão com a integração mcp do back4app, você pode aproveitar o poder dos agentes de ia para acelerar seu fluxo de trabalho de desenvolvimento desde a criação e configuração de aplicativos até a implantação de código e gerenciamento de dados, seu assistente de ia agora pode interagir perfeitamente com a plataforma back4app em seu nome