Motomarks MCP
Cada logotipo de carro, uma API simples
Documentação
Servidor Motomarks MCP
O servidor oficial do Model Context Protocol (MCP) para Motomarks: uma ponte hospedada na nuvem que dá às suas ferramentas de IA acesso seguro e em tempo real à API de logotipos de carros Motomarks e ao CDN de imagens.
Registro MCP: io.motomarks/mcp · Autenticação: OAuth 2.1 ou chave de API · Hospedagem: Motomarks Cloud
O Servidor Motomarks MCP conecta clientes compatíveis com MCP à biblioteca de marcas Motomarks. Uma vez configurado, suas ferramentas de IA podem pesquisar marcas automotivas, buscar dados de marcas e paletas de cores, navegar por ativos de logotipos e gerar URLs de imagens CDN prontas para incorporação. A autenticação usa OAuth 2.1 (login via navegador) ou uma chave de API secreta Motomarks, para que cada solicitação respeite seu plano e limites de taxa.
Com o Servidor Motomarks MCP, você pode:
- Pesquisar e inspecionar qualquer marca de carro publicada: nomes, slugs, descrições, cores, paletas, links sociais e dados da empresa.
- Navegar por ativos de logotipos por marca: logotipos completos, emblemas e wordmarks em webp, png e svg em cinco tamanhos.
- Gerar URLs de imagens CDN autenticadas com sua chave publicável, prontas para colar em HTML, React ou Markdown.
- Verificar sua conta: plano, status de atribuição e uso da API de hoje.
Configuração em um clique
| Adicionar ao Cursor | Adicionar ao VS Code |
|---|---|
| Referencie logotipos de marcas diretamente do seu código. | Pesquise marcas e incorpore logotipos via GitHub Copilot. |
Endpoint
https://motomarks.io/api/mcp
Transporte: HTTP streamable. Na primeira conexão, seu cliente executa um fluxo OAuth baseado em navegador (registro dinâmico de cliente + PKCE) na sua conta Motomarks. Não é necessário editar JSON ou gerenciar tokens manualmente.
Clientes suportados
| Cliente | Configuração |
|---|---|
| Claude (Claude.ai, Desktop, Code) | Adicione um conector personalizado com a URL do endpoint, ou use claude mcp add --transport http motomarks https://motomarks.io/api/mcp |
| Cursor | Instalação em um clique acima, ou adicione a URL em Configurações → MCP |
| VS Code (GitHub Copilot) | Instalação em um clique acima, ou "motomarks": { "type": "http", "url": "https://motomarks.io/api/mcp" } em mcp.json |
| Google Gemini CLI | gemini extensions install com este repositório, ou adicione o httpUrl ao settings.json |
| Qualquer cliente somente stdio | Conecte-se através do proxy mcp-remote (abaixo) |
Proxy local (clientes stdio)
Para clientes que falam apenas stdio, conecte-se através do mcp-remote:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://motomarks.io/api/mcp"]
}
}
}
Requer Node.js 20+. O proxy abre um navegador para login OAuth e armazena tokens em cache localmente.
Autenticação headless / chave de API
Para CI, backends ou configurações não interativas, autentique-se com uma chave de API secreta Motomarks (sk_..., criada no seu painel) em vez de OAuth, enviando-a como token Bearer:
Authorization: Bearer sk_...
Com o proxy local:
{
"mcpServers": {
"motomarks": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://motomarks.io/api/mcp",
"--header",
"Authorization: Bearer sk_..."
]
}
}
}
Ferramentas suportadas
| Ferramenta | Intenção | Descrição |
|---|---|---|
search_brands | leitura | Pesquise marcas publicadas por nome, empresa ou slug; opcionalmente inclua URLs de imagens CDN |
get_brand | leitura | Detalhes completos da marca: descrição, cores, paleta, links sociais, dados da empresa, FAQs |
list_brand_assets | leitura | Ativos de logotipo disponíveis (tipo, formato, tamanho, proporção, dimensões) com URLs CDN |
build_image_url | leitura | URL de imagem CDN determinística usando sua chave publicável |
describe_api_endpoint | leitura | Referência HTTP para as operações da API REST bruta |
get_account | leitura | Seu plano, status de atribuição e uso de hoje vs. limite |
Recursos: motomarks://docs/image-cdn, motomarks://docs/api-v1, motomarks://brand/{slug}.
Prompts: find_brand_logo, embed_brand_image.
Fluxos de trabalho de exemplo
- "Adicione o logotipo do emblema BMW a esta tabela de preços."
- "Quais são as cores da marca Lamborghini? Dê-me a paleta completa."
- "Liste todos os ativos wordmark da Toyota e escolha o melhor para uma barra de navegação escura."
- "Quantas solicitações de API ainda tenho hoje?"
Dados e segurança
- Todo o tráfego é criptografado em trânsito via HTTPS.
- OAuth 2.1 (PKCE, registro dinâmico de cliente) ou chaves de API com escopo controlam o acesso.
- As ferramentas respeitam seu plano Motomarks, requisitos de atribuição e limites de taxa.
- Chaves secretas nunca são ecoadas pelas ferramentas; a saída da conta as mascara.
Clientes MCP podem agir em seu nome. Use apenas clientes confiáveis, prefira o princípio do menor privilégio e revise seus aplicativos conectados no painel Motomarks. Consulte SECURITY.md para relatar problemas.
Publicação (mantenedores)
Este repositório não contém código de servidor — o servidor está hospedado em https://motomarks.io/api/mcp. Publicar significa listar o endpoint em registros e diretórios:
- Verifique o domínio
motomarks.iopara o namespace do registroio.motomarks(desafio DNS ou HTTP), depois publique o manifesto:mcp-publisher login dns --domain motomarks.io && mcp-publisher publishcom server.json. - Envie a entrada do registro / repositório para diretórios MCP (Registro MCP oficial, marketplace Cursor, conectores Claude, PulseMCP, Smithery, Glama).
Suporte
- Documentação: motomarks.io/docs/mcp
- Problemas: GitHub issues
- E-mail: support@motomarks.io