Charmshots
MCP OAuth somente leitura para sua conta, fotos existentes, metadados das fotos e links de download autenticados pelo proprietário. Não gera imagens nem gasta créditos. https://charmshots.com
Servidor MCP hospedado
npx add-mcp 'https://mcp.charmshots.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
MCP do Charmshots
Retratos com IA para perfis de namoro e apresentações do dia a dia.
O Charmshots cria retratos a partir das suas próprias selfies, com configurações e estilos para perfis de namoro, fotos de perfil profissional e apresentações do dia a dia. Escolha cenas que combinam com a sua vida, revise cada resultado com atenção e mantenha as fotos que parecem com você. A coleção de fotos, os guias práticos e as ferramentas gratuitas de imagem ajudam você a planejar um perfil mais bem pensado.
Site · Repositório do MCP · Habilidade do agente · Pacote npm
O que este conector faz
Este pacote conecta um cliente MCP local via stdio ao servidor MCP do Charmshots hospedado. As ferramentas hospedadas são executadas na Cloudflare; o pacote local faz a ponte da conexão e abre o OAuth baseado em navegador. Você não precisa implantar um Worker nem colar uma senha de produto no seu assistente.
| Ferramenta | O que ela faz |
|---|---|
get_profile | Lê o contexto da conta conectada. |
list_photoshoots | Navega pelas sessões de fotos existentes, das mais recentes para as mais antigas. |
get_photoshoot | Lê os metadados e o status da sessão selecionada. |
list_photos | Lista os rótulos de fotos existentes, estilos, status e links de download autenticados pelo proprietário. |
O MCP não gera nem analisa imagens e não gasta créditos. Os metadados das fotos não são uma avaliação visual de qualidade, e os links de download exigem o login do proprietário no produto. O site atualmente informa que as compras estão temporariamente pausadas; navegue pela coleção e disponibilidade atuais antes de planejar uma nova sessão. Retratos com IA não podem garantir combinações em aplicativos de namoro.
Fluxo de trabalho de exemplo
- Encontre a sessão de fotos solicitada na conta conectada.
- Liste as fotos disponíveis, distinguindo resultados prontos de trabalhos na fila ou incompletos.
- Retorne os links relevantes do produto ou de download para que o proprietário possa inspecionar as imagens reais.
Perguntas para fazer ao seu assistente
Encontre minha sessão de fotos mais recente e liste as fotos que estão prontas para download.
Mostre os rótulos e estilos desta sessão, com os links de download disponíveis.
Resuma o status das minhas sessões de fotos salvas sem gerar novas imagens.
Conecte um cliente MCP remoto
- Abra as configurações de MCP personalizado ou de conector do cliente.
- Insira
https://mcp.charmshots.com/mcpcomo URL do servidor remoto. - Conclua o login no Charmshots no seu navegador e revise as permissões na tela de consentimento.
- Volte ao cliente e carregue as ferramentas disponíveis.
Use um cliente que suporte Streamable HTTP MCP e OAuth. A disponibilidade de conectores personalizados depende do cliente e da sua conta. Um repositório público ou uma versão npm não significa que a integração foi aprovada para o marketplace de um cliente.
Claude Desktop e outros clientes stdio
Requer Node.js 22 ou mais recente e uma conta existente no Charmshots. Adicione esta entrada à configuração MCP do seu cliente:
{
"mcpServers": {
"charmshots": {
"command": "npx",
"args": [
"-y",
"charmshots-mcp"
]
}
}
}
Você também pode executar npx -y charmshots-mcp a partir de um terminal para iniciar a ponte. Ela fala MCP via stdio; não é uma interface de chat interativa. Para clientes desktop que suportam extensões MCPB, baixe o arquivo .mcpb das versões do Charmshots.
Permissões e acesso à conta
Escopos solicitados: profile:read photos:read. Conexões antigas apenas com perfil precisam se reconectar e aprovar explicitamente as permissões adicionais antes que as ferramentas de conteúdo fiquem disponíveis.
Aprove apenas uma conexão que você pretendia iniciar. Se o login abrir uma nova aba, conclua-o, volte à tela de consentimento e atualize. Gerencie ou revogue aplicativos conectados.
O pacote usa mcp-remote fixado para OAuth, PKCE e armazenamento local de tokens. Os tokens no seu computador são credenciais. O conector usa o endpoint fixo acima e rejeita substituições de endpoint pela linha de comando. Senhas de produto e credenciais do provedor subjacente não são solicitadas por este pacote.
Solução de problemas
- Sem ferramentas ou permissões insuficientes: reconecte-se pelo consentimento do navegador e verifique a conta selecionada.
- Uma lista vazia: confirme se a conta possui os itens esperados. Resultados vazios são diferentes de uma solicitação com falha.
- Um link pede para você entrar: abra-o com a conta do produto proprietário; um link privado de produto não é um link público de compartilhamento.
- O navegador bloqueia a autorização: inspecione o erro exibido no navegador e reinicie uma solicitação expirada a partir do cliente. Nunca envie cookies ou tokens em um problema.
Adicione a habilidade complementar
A habilidade do agente Charmshots explica como selecionar os registros certos, interpretar resultados e respeitar os limites do fluxo de trabalho:
npx skills add charmshots/agent-skill
Saiba mais sobre o Charmshots
- Retratos com IA para namoro
- Coleção de estilos de foto
- Fotos de perfil profissional
- Monte uma seleção de fotos para namoro
- Usando fotos com IA com honestidade
- Editor de fotos gratuito
- Conversor de imagens
Desenvolvimento e suporte
npm ci
npm test
npm run bundle
Relate um problema do conector com seu cliente, versão do Node.js e um erro editado. Mantenha package.json, manifest.json, server/config.json, server.json e a versão do lockfile alinhados para as versões. O GitHub Actions publica pacotes npm versionados e ativos MCPB. Consulte LICENSE para a licença MIT.