O Grilled Cheese fala o Model Context Protocol (MCP), o padrão aberto que os assistentes de IA usam para trabalhar com serviços de fora. Conecte o Claude, o ChatGPT ou qualquer outra ferramenta com suporte a MCP, e ela pode ler a sua linha do tempo, publicar, seguir, reagir e editar temas por você. As ferramentas que aceitam uma chave colada usam uma que você mesmo cria e pode revogar quando quiser; as que falam o fluxo OAuth do MCP, como o ChatGPT, conectam por uma tela de consentimento, sem nada para copiar.

O que conectar quer dizer de fato

Um cliente MCP enxerga o Grilled Cheese como um conjunto de ferramentas com nome: ler a linha do tempo, criar uma publicação, seguir alguém, editar um tema. A IA decide quando chamá-las; a sua chave decide o que ela pode fazer. Uma chave age como você, nas identidades que você indicar ao criá-la, e nunca ganha poderes que a sua própria conta não tem.

Toda conta pode conectar uma ferramenta para ler e para escrever (publicar, seguir, reagir, editar temas).

Criando uma chave

As chaves ficam em Configurações > Programador, no app web em https://grilledcheese.app/settings/developer ou no app, em Configurações.

  1. Escolha um nome que diga onde a chave vai morar ("Assistente do notebook", "Servidor de casa").

  2. Escolha as identidades pelas quais a chave pode agir. Uma chave com várias identidades precisa dizer por qual está agindo a cada escrita, então a maioria das chaves indica exatamente uma.

  3. Escolha os escopos dela. Os escopos de leitura e de escrita estão abertos a toda conta.

  4. Copie a chave quando ela for mostrada. Ela é mostrada uma única vez: só uma impressão digital é guardada, então nada consegue exibi-la de novo. Perdê-la significa criar outra.

Há um teto de quantas chaves uma conta pode ter ao mesmo tempo: revogue uma chave para abrir espaço para outra. As chaves também expiram sozinhas depois de 90 dias, então uma chave esquecida não fica viva para sempre.

Escopos

Um escopo é uma permissão que a chave tem. Uma chamada de ferramenta fora dos escopos da chave é recusada, sempre, seja quem for o dono da chave.

Escopo O que permite Ferramentas

posts:read

Ler linhas do tempo, publicações, tópicos e busca

get_timeline, get_post, get_thread, search_posts

follows:read

Ler quem você segue e quem segue você

(só API, ainda sem ferramenta)

reactions:read

Ler as suas reações

(só API, ainda sem ferramenta)

themes:read

Ler os seus temas

list_themes

identity:read

Ler o seu perfil

(só API, ainda sem ferramenta)

posts:write

Criar publicações e excluir as publicações que a própria chave fez

create_post, delete_post

follows:write

Seguir e deixar de seguir

follow, unfollow

reactions:write

Reagir e remover as reações que a própria chave fez

react, unreact

themes:write

Criar e editar os seus temas

create_theme, update_theme

Toda conta pode conceder qualquer um destes escopos. Dê a uma chave só os que a ferramenta dela precisa: uma chave sem os escopos :write pode ler, mas não pode publicar nem seguir em seu nome.

Conectando um cliente

Direto (Streamable HTTP)

A maioria dos clientes MCP atuais, incluindo o Claude Code e as versões mais novas do Claude Desktop, conecta direto ao endpoint hospedado:

https://grilledcheese.app/mcp

com a chave como bearer token. No Claude Code, uma linha:

claude mcp add --transport http grilledcheese https://grilledcheese.app/mcp --header "Authorization: Bearer <key>"

Pela ponte stdio

Os clientes que só conseguem iniciar um processo local usam o pacote de ponte, @grilledcheese/mcp. Ele roda na sua máquina, guarda a chave localmente e repassa cada requisição ao endpoint acima; a chave nunca aparece num serviço de configuração compartilhado.

No Claude Desktop, acrescente ao claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "grilledcheese": {
      "command": "npx",
      "args": ["-y", "@grilledcheese/mcp"],
      "env": { "GRILLEDCHEESE_KEY": "<key>" }
    }
  }
}

No Claude Code, o equivalente em stdio é:

claude mcp add grilledcheese --env GRILLEDCHEESE_KEY=<key> -- npx -y @grilledcheese/mcp

Qualquer outro cliente stdio deve ser configurado para iniciar npx -y @grilledcheese/mcp --key <key>. Uma chave com mais de uma identidade passa --identity para dizer por qual ela age.

ChatGPT e outros clientes OAuth

Os conectores personalizados do ChatGPT não aceitam uma chave colada. Eles exigem o fluxo OAuth do MCP, e o Grilled Cheese o fala. Nenhuma chave está envolvida: você aprova a conexão no seu navegador, conectado como você mesmo, e consegue ver exatamente o que está sendo concedido antes que algo seja.

Para conectar o ChatGPT:

  1. No ChatGPT, abra Settings > Connectors e adicione um conector personalizado com a URL do servidor:

    https://grilledcheese.app/mcp

  2. O ChatGPT descobre que o Grilled Cheese tem suporte a OAuth e abre uma janela do navegador na página de entrada do Grilled Cheese. Entre, se ainda não estiver.

  3. A tela de consentimento mostra o nome do conector, para onde você vai ser mandado de volta e um seletor de identidades e escopos, exatamente como ao criar uma chave. Os escopos de leitura vêm pré-selecionados, e qualquer conta pode conceder também os de escrita.

  4. Aprove, e o ChatGPT termina a conexão sozinho.

Uma conexão feita assim se renova em silêncio enquanto está em uso, e expira sozinha depois de 90 dias sem uso. As mesmas regras das chaves valem a cada chamada: a conexão nunca é mais poderosa que você, e tudo o que ela faz é atribuído na trilha de auditoria.

Aprovar o mesmo conector de novo substitui a conexão anterior, então reconectar nunca deixa uma segunda concessão viva para trás. Se você achar que uma conexão está sendo mal usada, remova o conector no ChatGPT e escreva para [email protected]; a equipe pode revogar uma conexão na hora, o que corta os tokens dela já na chamada seguinte.

A tela de consentimento também avisa quando um conector pede para mandar você de volta a um endereço no seu próprio computador. Isso é normal em ferramentas de desktop como o Claude Code, e merece um segundo olhar em qualquer outra coisa.

Revogando uma chave

Revogue na mesma tela Configurações > Programador: cada chave mostra os seus escopos, identidades, data de criação e validade, com um botão de revogar ao lado. A revogação vale na hora, já na chamada seguinte da chave. Revogue uma chave no momento em que você parar de usar a ferramenta que a tinha, ou se desconfiar que ela vazou.

Notas de segurança

  • Uma chave nunca é mais poderosa que você. Ela fica limitada aos poderes de um usuário comum mesmo que você seja da equipe, e tudo o que ela faz cai na mesma trilha de auditoria das suas próprias ações, atribuído à chave.

  • Algumas coisas simplesmente não estão no protocolo. As conversas e as mensagens diretas, o seu círculo próximo, a recuperação de conta, os pagamentos e a moderação nunca podem ser alcançados por chave nenhuma, com escopo nenhum.

  • As ferramentas destrutivas se anunciam. As ferramentas que excluem algo são sinalizadas, então clientes bem-comportados perguntam antes de chamá-las.

  • Trate a chave como uma senha. Quem a tiver pode agir pelas identidades que ela indica, dentro dos escopos dela, até que ela expire ou você a revogue. Prefira as formas com variável de ambiente mostradas acima a colar chaves em linhas de comando, e nunca envie uma chave para um repositório.

Dúvidas ou uma conexão travada vão para [email protected].