Conecte o ideare a um app de IA

Claude, ChatGPT, Cursor e outros apps de IA podem ler suas marcas, salvar mudanças no rascunho, conferir tudo e fazer posts. Nada vai ao ar antes de um dono aprovar.

O endereço

Os apps de IA se conectam ao ideare por MCP, um jeito padrão de um app de IA usar outro serviço. Todos os apps abaixo usam este mesmo endereço:

https://api.ideare.app/mcp

Do que você precisa

Uma conta no ideare, no espaço das marcas que o app vai usar.
No Claude e no ChatGPT, você entra com a sua conta do ideare e não copia chave nenhuma.
O Claude Code e o Cursor pedem uma chave de API. Crie uma no estúdio, em Chaves de API. Ela começa com ideare_ e aparece uma vez só, então copie na hora. Só donos e admins criam chaves.
No plano grátis, toda chave só lê: o app vê suas marcas, mas não muda nada. O grátis tem 1 chave, e cada app conectado usa uma. O Pro tem 5, que também mandam mudanças.

Nunca cole uma chave numa conversa. Ela vai nas configurações do app e em mais nenhum lugar.

Criar uma chave no estúdio

Claude (no computador e na web)

Abra Personalizar (Customize) e depois Conectores (Connectors).
Clique em + Adicionar (+ Add) e escolha Adicionar conector personalizado (Add custom connector).
Dê o nome ideare, cole o endereço e clique em Continuar. Na tela seguinte, continue de novo.
Em Autenticação, escolha Entrar agora (Sign in now), deixe a opção recomendada e clique em Adicionar.
O ideare abre numa aba. Entre, escolha o espaço e clique em Permitir.

No plano grátis do Claude dá pra adicionar um conector personalizado. No Team e no Enterprise, um dono adiciona o conector pra todo mundo nas configurações da organização, e cada pessoa conecta o seu.

ChatGPT

Na web, num plano pago. Ative o modo de desenvolvedor nas Configurações, em Apps. Depois crie um app, cole o endereço e deixe OAuth como forma de entrar. O ChatGPT abre o ideare pra você entrar e permitir, como no Claude.

O ChatGPT muda esses menus com frequência. Se o modo de desenvolvedor não aparece, o seu plano ou o admin do seu espaço de trabalho pode não liberar.

Claude Code

No terminal, com a sua chave no lugar de ideare_your_key:

claude mcp add --transport http ideare https://api.ideare.app/mcp --header "Authorization: Bearer ideare_your_key"

Ou tire o --header e digite /mcp no Claude Code pra entrar pelo navegador.

Cursor

Coloque isto em ~/.cursor/mcp.json, o arquivo na sua pasta pessoal, pra chave nunca parar no git de um projeto:

{
  "mcpServers": {
    "ideare": {
      "url": "https://api.ideare.app/mcp",
      "headers": {
        "Authorization": "Bearer ideare_your_key"
      }
    }
  }
}

A maioria dos outros apps que aceitam um servidor MCP remoto lê esse mesmo formato.

Seu primeiro pedido

Peça ao seu app:

Mostre a minha marca padaria-fermento no ideare.

Ele chama get_brand com um argumento só, o slug da marca:

{"slug":"padaria-fermento"}

Volta a marca: nome, cores, fontes e logo, e a imagem de compartilhamento quando ela já tem uma versão aprovada.

O slug é a parte depois de ideare.app/b/ no endereço da página pública da marca. Não sabe qual é? Pergunte antes "Quais marcas eu tenho no ideare?".

O que o app pode fazer

Estas são as ferramentas do app, por tarefa. Ele escolhe sozinho qual usar: você só pede com as suas palavras.

Ver suas marcas

As marcas, o rascunho, as versões aprovadas e os arquivos delas, os arquivos que a sua equipe enviou e os créditos que sobram. Ver não gasta nada.

list_brandsget_brandlist_versionsget_versionlist_fileslist_assetsget_usage

Mudar o rascunho e pedir aprovação

Criar uma marca, salvar o rascunho, conferir antes de aprovar, trazer de volta uma versão antiga e mandar pro dono aprovar.

create_brandupdate_draftcheck_brandrestore_versionapprove_draft

Começar do que você já tem

Ler uma marca a partir de um link (o seu site ou um perfil nas redes), dos seus arquivos ou de uma pasta inteira de marca, e usar o que ele achou.

import_linkimport_filesimport_folderget_folder_importapply_import

Nomes e textos

Sugerir nomes, frases e textos pra marca, e ver se um nome está livre como domínio e como @ nas redes. Grátis, até um limite por dia.

generate_textcheck_names

Imagens com IA

Desenhar ideias de símbolo e artes no estilo da marca. Estas gastam créditos: 1 por ideia de símbolo, 1 por arte e 2 por uma arte maior, em 2K.

generate_symbolsgenerate_art

Posts

Desenhar um post a partir de um modelo (promoção, horário, cardápio, produto novo, Pix) ou exportar um que você fez no editor do estúdio.

render_templatelist_designsrender_design

Trabalho demorado

Acompanhar o que leva um tempo, como as imagens com IA ou a leitura de uma pasta, ou parar no meio.

get_runcancel_run

O que ele não faz

O app age como você, com o seu papel no espaço. Ele só vê o que uma ferramenta devolve.

Ele não publica. Quando pede aprovação, o dono recebe um pedido e aprova no estúdio com um toque.

Ele não apaga marcas, não mexe em quem faz parte da equipe, não compra créditos e não cria nem apaga chaves.

Corte o acesso de um app

Apague a chave dele no estúdio, em Chaves de API. O app para na hora. A chave de um app conectado leva o nome do app.

Depois tire o ideare do app também, pra ele esquecer a chave.

O que o app vê e o que o ideare guarda

Pra quem programa

O servidor fala MCP por Streamable HTTP: só POST, sem sessão, uma resposta JSON por pedido.

Mande a chave como Authorization: Bearer ideare_.... Sem chave, ele responde 401 com um cabeçalho WWW-Authenticate que aponta os metadados de OAuth, e um app que entende OAuth faz o login sozinho.

O primeiro pedido, feito à mão:

curl https://api.ideare.app/mcp \
  -H "Authorization: Bearer ideare_your_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brand","arguments":{"slug":"padaria-fermento"}}}'

tools/list devolve cada ferramenta com o esquema de entrada. A mesma lista, com as rotas REST, está no arquivo OpenAPI e no llms-full.txt.