MCP

Pedes, e a página muda

O Linktotem fala MCP, por isso o Claude, o Cursor ou qualquer cliente que o faça conseguem ler a tua página e alterá-la. “Acrescenta o meu episódio novo no topo” passa a ser uma frase, não uma sessão no editor.

Não há rascunhos

Tudo o que um assistente muda fica logo no ar na página pública — tal e qual como se fosses tu a editar. Pede-lhe que leia a página antes de mexer, e que te diga o que fez.

Como se liga

Estar no Pro: a API e o servidor MCP fazem parte dele.
Criar uma chave em Definições › API. Escolhe “leitura e escrita” para um assistente que deva alterar a página; “só leitura” chega para lhe fazer perguntas.
Pôr a chave na configuração do teu cliente, aqui em baixo. A chave só aparece uma vez, por isso cola-a enquanto está no ecrã.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "linktotem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://linktotem.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer app_live_…" }
    }
  }
}

A chave fica no `env` e não nos `args`: no Windows, o espaço de “Bearer x” estraga-se a caminho do npx, e é por isso que o cabeçalho vai partido em dois.

Claude Code

claude mcp add --transport http linktotem https://linktotem.com/api/mcp \
  --header "Authorization: Bearer app_live_…"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "linktotem": {
      "url": "https://linktotem.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKTOTEM_KEY}" }
    }
  }
}

O Cursor resolve variáveis de ambiente dentro dos cabeçalhos, por isso a chave não fica num ficheiro que possas vir a commitar.

ChatGPT

Os conectores do modo de programador do ChatGPT só aceitam OAuth ou nenhuma autenticação, e o nosso servidor abre-se com uma chave de API. Até acrescentarmos OAuth, usa um cliente que envie um cabeçalho — o Claude ou o Cursor aqui em cima.

Coisas para dizer

“Acrescenta o meu episódio novo no topo da página, a apontar para open.spotify.com/…”
“Esconde o link dos bilhetes, o evento já passou.”
“Põe a newsletter em primeiro e os ícones sociais no fim.”
“Põe o fundo escuro e os botões redondos.”
“Quantas pessoas subscreveram esta semana, e de onde vieram?”

As ferramentas

Treze, com os limites da API: 120 chamadas por minuto por chave, das quais 30 podem alterar alguma coisa.

list_profilesTodas as páginas da conta.
get_profileO cabeçalho, as páginas, os blocos de uma página e o tema. É a primeira a chamar.
get_form_submissionsRespostas que as pessoas enviaram pelos formulários, as mais recentes primeiro.
get_subscribersOs endereços que os formulários recolheram.
screenshot_profileUma fotografia da página publicada.
update_profileescreveNome, slogan, bio, formato do cabeçalho ou nome de utilizador.
update_themeescreveCores, tipos de letra, botões, fundo. Junta-se ao tema que a página já tem.
update_social_iconsescreveA fila de ícones sociais da página inicial.
add_blockescreveUm bloco de link, título, texto, ícones sociais, media ou pasta, no topo ou no fim.
update_blockescreveUm campo de um bloco, sem perder o resto.
toggle_blockescreveEsconder um bloco da página pública, ou voltar a mostrá-lo.
delete_blockescreveApagar um bloco de vez.
reorder_blocksescrevePôr os blocos de uma página noutra ordem.

A tua página à distância de uma frase

Cria conta, faz uma chave e aponta o teu assistente para ela.

Começar Ver a API