Como criar uma chave de API

Sua chave de API é o que permite que um assistente de IA (ou seu próprio código) aja em sua conta do MagicPost. Você precisará de uma para o Claude Desktop, o Perplexity ou para chamar a API diretamente.

Você não precisa criar uma para o Claude na web, ChatGPT ou Gemini: eles se conectam por meio de OAuth, e a chave é criada para você quando você aprova a conexão. Ela aparece na mesma lista abaixo, e você a revoga da mesma forma.

Criar uma chave

1. No MagicPost, acesse as configurações da sua conta, na aba API & MCP.

2. Clique em Criar uma chave.

3. Dê um nome baseado no que você deseja conectar: "Claude Desktop", "Perplexity", "meu script". O nome é apenas para você, e você ficará feliz por ter sido específico quando tiver quatro deles.

4. Copie a chave imediatamente.

A chave começa com mp_. Ela é exibida exatamente uma vez, no momento da criação, e nunca mais. Se você fechar a caixa de diálogo sem copiá-la, ela será perdida para sempre. Você terá que criar outra.

Trate-a como uma senha

Uma chave dá acesso total à sua conta: ela pode ler suas métricas, publicar postagens no seu LinkedIn e consumir seus créditos.

• Nunca a cole em um repositório público, em um documento compartilhado ou em uma captura de tela.

• Nunca a compartilhe com outra pessoa. Dê a ela seu próprio acesso.

• Se suspeitar que ela vazou, revogue-a imediatamente e crie uma nova.

Gerenciar suas chaves

A mesma tela lista suas chaves, com seu prefixo e a data de criação, nunca a chave em si, pois não a mantemos guardada.

• Até 10 chaves ativas por conta. O suficiente para uma por ferramenta. Chaves criadas por uma conexão OAuth (Claude web, ChatGPT, Gemini) não contam para este limite.

• Revogue qualquer chave a qualquer momento. A revogação é permanente: uma chave revogada não pode ser reativada. Para uma conexão OAuth, a revogação da chave desconecta o assistente; reconectar gera uma nova chave.

Use uma chave por ferramenta. Quando deixar de usar uma ferramenta, revogue sua chave. Dessa forma, um vazamento nunca significará revogar tudo.

Como usá-la

Para um assistente de IA, siga as instruções em Como conectar o MagicPost ao Claude ou Como conectar o MagicPost ao Perplexity.

Para a API, envie-a como um token de portador (bearer token):

Authorization: Bearer mp_your_token

A URL base é https://api.magicpost.in/api/v1/, e a referência completa está em https://dev.magicpost.in**.

Limites de taxa: 60 requisições por minuto por chave. Dois endpoints de processamento mais pesado estão limitados a 5 requisições por minuto: a atualização de posts do LinkedIn e a detecção de leads. Acima do limite, a API responde HTTP 429.

Perguntas Frequentes (FAQ)

Perdi minha chave.

Ela não pode ser recuperada. Nós nunca a armazenamos em texto simples, e é exatamente por isso que ela é segura. Revogue-a e crie uma nova.

Revoguei uma chave e ela ainda funciona.

A revogação leva até um minuto para se propagar. Depois disso ela deixa de funcionar completamente.

Como sei se uma chave ainda funciona?

Seu assistente avisará em breve: as ferramentas pararão de responder. A partir do código, faça uma chamada GET para /api/v1/auth/verify.

De qual plano eu preciso?

O acesso à API e ao MCP vem incluso no plano Creator e superiores.

Precisa de ajuda?

Entre em contato pelo chat do aplicativo ou agende uma chamada de integração de 30 minutos: https://cal.com/magicpost-team/contact-sales-team