PODIE MCP

npx add-mcp 'https://podie.dev/api/podie/mcp'

PODIE MCP para Codex e Claude Code

O PODIE MCP permite que Codex e Claude Code pesquisem uma biblioteca de UI React selecionada, recomendem componentes e modelos de aplicativos, recuperem seu código-fonte e preparem comandos de instalação. Seu editor aplica a UI selecionada ao seu projeto local. Você não precisa lembrar nomes de ferramentas.

Conecte uma vez. Depois, peça a UI que você precisa.

1. Entre no PODIE e abra Connect PODIE MCP.
2. Escolha Codex ou Claude Code e clique em Copy setup prompt.
3. Cole no seu editor. O prompt pede que ele preserve as configurações existentes e adicione o PODIE à sua configuração MCP no nível do usuário.
4. Se o editor solicitar uma recarga do servidor, conclua essa etapa. Depois, peça um componente. O diálogo do PODIE mostra Connected · tool call confirmed somente após uma chamada de ferramenta bem-sucedida.

Use PODIE to find 3 UI components that fit this project. Show previews and explain the fit before installing.

Depois de escolher um:

Install the second option. Keep this project's package manager and existing design. Integrate it into the page, then run the type check and production build.

O que acontece entre uma solicitação e um componente funcional?

Pesquisar e recomendar

O agente pesquisa entradas publicadas e pode pedir recomendações ao PODIE usando um breve resumo de design. Os resultados vinculam a páginas de pré-visualização reais.

Inspecionar

Ele lê o código-fonte selecionado, as dependências e a licença antes de adaptar qualquer coisa. Um componente React nativo e um wrapper de cena isolado têm limites de integração diferentes.

Instalar e verificar

O PODIE retorna um plano de instalação compatível com shadcn. Seu editor o executa com sua autorização, importa o componente e o verifica no seu aplicativo.

O servidor MCP remoto não pode modificar seu sistema de arquivos nem executar um shell no seu computador. Uma pesquisa bem-sucedida prova que a conexão funciona; não prova que o componente foi instalado. Aceite o resultado somente depois de vê-lo funcionando no seu projeto.

Quais ferramentas MCP estão disponíveis?

• search_catalog: encontre componentes ou Apps.
• recommend_ui: obtenha sugestões para um resumo não sensível. Se o modelo estiver indisponível, correspondências de catálogo explicitamente rotuladas serão retornadas.
• get_component: inspecione código-fonte e dependências.
• get_install_plan: obtenha o comando para o seu gerenciador de pacotes.
• report_installation: opcionalmente, registre resultados para uma instalação rastreada, com permissão. Esses são resultados relatados pelo cliente.

Como isso é diferente de um registro shadcn?

Um registro entrega arquivos de código-fonte e dependências. O PODIE MCP adiciona pesquisa de catálogo, recomendações e planos de instalação à conversa do editor. Ele usa entrega compatível com shadcn; não é o servidor MCP oficial do shadcn. Você também pode instalar diretamente sem MCP usando o guia de CLI.

Solução de problemas de conexão

• Configuração salva, mas sem ferramentas: recarregue o servidor usando os controles suportados do seu editor e envie a primeira solicitação acima. Salvar um arquivo sozinho não é um teste de conexão.
• Aguardando seu editor: nenhuma chamada bem-sucedida chegou para este token ainda. Use Check connection no diálogo.
• Token expirado ou 401: copie um novo prompt de configuração e atualize o editor. Os tokens expiram após 30 dias; reconectar substitui o token anterior desse editor.
• 403 antes da ferramenta ser executada: distinga um bloqueio de borda/rede de um erro de autenticação MCP. Verifique a conexão nativa do editor; compartilhe um erro editado ao relatar o problema.
• Falha na instalação ou no estilo: verifique aliases, dependências e estilos no guia de instalação. Uma pré-visualização não é prova de compatibilidade com todos os projetos.

O que é enviado ao PODIE?

Mantenha código-fonte privado, credenciais e dados de clientes no seu projeto. Envie apenas um breve resumo de design e stack não sensíveis. As recomendações do modelo enviam esse resumo e metadados públicos do catálogo para a AtlasCloud. O prompt de configuração contém um token de conta privado e revogável; mantenha-o nas configurações do editor no nível do usuário, fora do controle de versão. Desconecte um editor pelo diálogo de conexão para revogar o acesso.

Navegue pelos modelos de aplicativos, guias de componentes ou pela biblioteca ao vivo. Detalhes de configuração do editor: documentação oficial do Codex MCP e documentação oficial do Claude Code MCP.

Última atualização: .