Como criar uma chave de API
|Uma chave de API do MagicPost permite que um assistente de IA ou seu próprio código execute ações na sua conta do MagicPost. Você cria uma chave no app: abra o menu do perfil, selecione Configurações e abra a aba API e MCP. As chaves de API estão incluídas nos planos Creator, Agency e Team, bem como durante o teste gratuito do MagicPost. O plano Growth não inclui chaves de API.
Você cria uma chave de API do MagicPost para chamar a API REST do MagicPost e para os três assistentes que o app MagicPost configura com uma chave: Claude Desktop, Claude Code e Perplexity. O Claude Code também pode se conectar por meio de um login do MagicPost, sem chave. Você não cria uma chave para o Claude na web, o ChatGPT ou o Gemini. Esses três assistentes se conectam por meio de um login do MagicPost, e o MagicPost cria a chave para você quando você aprova a conexão.
Quem pode criar uma chave de API do MagicPost
Creator, Agency e Team. As chaves de API e o servidor MCP do MagicPost fazem parte desses planos.
Teste gratuito. As chaves de API ficam disponíveis enquanto durar o teste gratuito do MagicPost. Uma chave para de funcionar quando o teste termina sem uma assinatura de um desses planos.
Membros de uma organização. Um membro de uma organização Agency ou Team pode criar chaves de API do MagicPost. Há uma exceção no Agency, onde os assentos têm tipos: um assento Growth, Analytics ou Engagement não inclui chaves de API. O assento Creator, que tem acesso completo, inclui essas chaves.
Growth. O plano Growth não inclui chaves de API, e o MagicPost não mostra a aba API e MCP para um assinante do Growth.
Uma assinatura de um plano antigo do MagicPost segue suas próprias regras: consulte Os planos Analytics e Starter. Para mudar para um plano que inclui chaves de API, consulte como fazer upgrade do seu plano do MagicPost.
Como criar uma chave de API do MagicPost
No MagicPost, abra o menu do perfil e selecione Configurações.
Abra a aba API e MCP. O link direto é app.magicpost.in/settings?tab=api-keys.
Clique em Criar uma chave. Quando a lista de chaves está vazia, o botão da lista exibe Criar sua primeira chave.
Na janela Criar uma chave de API, preencha Nome da chave com a ferramenta que você está conectando, por exemplo, "Claude Desktop". O nome é obrigatório.
Clique em Criar. A janela Chave de API criada exibe a chave.
Clique em Copiar ao lado da chave e armazene-a em um local seguro.
Clique em Copiei, fechar.
Uma chave de API do MagicPost começa com mp_. O MagicPost mostra a chave completa apenas uma vez, na janela Chave de API criada. O MagicPost armazena um hash da chave, não a chave, portanto ninguém poderá exibi-la novamente depois. Se você fechar a janela sem copiar a chave, crie uma nova.
O que a janela "Chave de API criada" oferece
Abaixo da chave, a janela Chave de API criada do MagicPost tem uma aba para cada assistente, com o conteúdo e o local onde colá-lo:
Claude Desktop: um bloco de configuração com sua chave já preenchida, para colar no arquivo claude_desktop_config.json.
Claude Code: um comando com sua chave já preenchida, para executar no terminal. O Claude Code também pode se conectar sem uma chave, por meio de um login do MagicPost: a página do Claude Code na documentação para desenvolvedores do MagicPost descreve esse método.
Perplexity: o endereço do servidor MCP do MagicPost, para adicionar como um conector personalizado com autenticação por chave de API.
Claude Web, ChatGPT e Gemini: somente o endereço do servidor MCP do MagicPost, pois esses assistentes não precisam de uma chave.
A configuração de cada assistente está em Como conectar o MagicPost ao Claude, ChatGPT, Gemini e Perplexity. O que um assistente conectado pode fazer no MagicPost está em O que é MCP e o que posso fazer com ele? Para uma visão geral do produto, consulte a página do recurso LinkedIn MCP.
Como gerenciar e revogar suas chaves de API do MagicPost
A lista Suas chaves na aba API e MCP mostra cada chave de API ativa do MagicPost com seu nome, seus primeiros caracteres, sua data de criação e a data em que foi usada pela última vez. A lista nunca mostra uma chave completa.
As chaves de API do MagicPost criadas por um login do Claude na web, ChatGPT ou Gemini aparecem na mesma lista, com o nome que o assistente forneceu ao se conectar.
Para revogar uma chave de API do MagicPost, clique no ícone de lixeira na linha correspondente e clique em Revogar na janela Revogar esta chave de API?. A API do MagicPost verifica a chave em cada solicitação, portanto uma chave revogada para de funcionar imediatamente. A revogação é permanente: uma chave revogada não pode ser reativada. As chaves revogadas permanecem visíveis em uma seção recolhida abaixo da lista.
Uma chave de API do MagicPost não expira. A chave funciona até que você a revogue ou até que a conta do MagicPost perca o acesso à API.
O MagicPost limita o número de chaves de API ativas em uma conta. O app MagicPost contabiliza todas as chaves ativas na lista Suas chaves, incluindo as chaves criadas por um login do Claude na web, ChatGPT ou Gemini. Quando você atinge o limite, Criar uma chave fica desativado e a aba API e MCP mostra o máximo. Revogue uma chave ou uma conexão de assistente que você não usa mais para criar uma nova chave.
O limite do MagicPost para chaves de API ativas bloqueia apenas Criar uma chave no app. Um login do Claude na web, ChatGPT ou Gemini ainda é aceito quando a conta está no limite, e a chave dessa conexão é adicionada à lista Suas chaves.
A que uma chave de API do MagicPost dá acesso
Uma chave de API do MagicPost dá acesso à sua conta inteira, não a uma parte dela. Com sua chave, uma ferramenta pode ler seus rascunhos e suas métricas do LinkedIn, criar e agendar posts, publicar na sua conta do LinkedIn e usar seus créditos de Leads. Mantenha a chave em segredo e crie uma chave por ferramenta para poder revogar uma sem interromper as outras.
Em uma organização Agency ou Team, uma chave criada a partir da conta de um administrador também alcança as contas dos membros: ela pode listá-los, ler suas métricas e seus posts e criar e agendar posts para eles.
Uma agência não precisa de uma chave de API do MagicPost por cliente. Uma chave criada a partir da conta de um membro que não é administrador fica limitada à conta desse membro.
Como usar uma chave de API do MagicPost com a API REST
Para chamar a API REST do MagicPost, envie a chave no cabeçalho Authorization como um token bearer: a palavra Bearer, um espaço e depois sua chave. O endereço base da API é https://api.magicpost.in/api/v1/. A referência da API está na documentação para desenvolvedores do MagicPost. Ela abrange chaves de API, métricas, posts e agendamento.
Uma chave de API do MagicPost, sozinha, não faz upload de um arquivo de mídia para um post pela API REST: somente o servidor MCP do MagicPost anexa um arquivo a um rascunho. Uma chamada REST direta ainda pode editar o título e o texto alternativo de uma mídia que já esteja anexada.
A API do MagicPost limita o número de solicitações por minuto para cada chave. A atualização de posts do LinkedIn e a detecção de leads têm um limite por minuto mais rigoroso. A publicação e o agendamento de um post têm seu próprio limite por minuto. A geração de posts tem seus próprios limites por minuto, por dia e por semana. Ao ultrapassar um limite, a API do MagicPost responde com o status HTTP 429, e a resposta informa o limite aplicável.
A documentação para desenvolvedores do MagicPost informa os valores em dois lugares. A página de erros e limites de taxa informa o limite padrão por minuto e o limite para atualizar posts. A entrada generate_post da página de ferramentas informa os limites de geração de posts.
O MagicPost também limita quantos posts um perfil do LinkedIn pode publicar a cada 24 horas, e os posts agendados também entram na contagem. Ao ultrapassar esse limite, a API do MagicPost recusa a publicação ou o agendamento com o status HTTP 429, e a resposta informa o limite e o próximo horário disponível. O limite depende da conta.
Perguntas frequentes
Perdi minha chave de API do MagicPost. Posso vê-la novamente?
Não. O MagicPost mostra uma chave de API apenas uma vez, quando você a cria, e armazena somente um hash dela. Revogue a chave perdida em Configurações, API e MCP, depois crie uma nova chave e substitua-a na sua ferramenta.
Por que não há uma aba API e MCP nas configurações do meu MagicPost?
O MagicPost oculta a aba API e MCP em dois casos: você está no plano Growth ou é membro de uma organização Agency com um assento Growth, Analytics ou Engagement. As chaves de API estão incluídas nos planos Creator, Agency e Team. Em uma conta gratuita cujo teste terminou, a aba fica visível, mas Criar uma chave abre uma janela de upgrade.
Preciso de uma chave de API do MagicPost por cliente ou por membro da equipe?
Não. Em uma organização Agency ou Team, uma chave criada a partir da conta de um administrador alcança as contas de todos os membros. Se você preferir uma chave por membro, crie-a nas configurações da conta desse membro.
Uma conexão do ChatGPT, Gemini ou Claude na web cria uma chave?
Sim. Quando você aprova a conexão na página de autorização do MagicPost, o MagicPost cria uma chave de API com o nome fornecido pelo assistente. O MagicPost lista essa chave na aba API e MCP, e revogá-la desconecta o assistente. Quando um conector que o MagicPost já conhece faz login novamente, o MagicPost revoga a chave que esse conector tinha e cria uma nova.
Minha chave de API do MagicPost parou de funcionar. Por quê?
Há dois motivos comuns. A chave foi revogada na aba API e MCP. Ou a conta não tem mais acesso à API, por exemplo, depois que o teste gratuito terminou ou após uma mudança para um plano sem chaves de API. No segundo caso, a API do MagicPost informa que o acesso à API e ao MCP não está incluído no seu plano.
Precisa de ajuda?
Entre em contato pelo chat no app ou agende uma chamada de integração de 30 minutos: https://cal.com/magicpost/book-a-call