Traga seu agente

Disponível

Seu assistente pode montar sua casa. As chaves continuam com você.

Conecte o Claude, ou qualquer app que fale MCP, ao seu espaço de trabalho no Mini Casa. Peça para ele criar uma casa, escrever os posts, conectar seu domínio e conferir o DNS. Ele usa as mesmas ferramentas que você, só com as permissões que você der.

Gerar um token Criar uma casa

106 ferramentas no total. Um token novo começa só com leitura, e você libera o resto uma permissão de cada vez.

Você

Cria uma casa para o meu ateliê de cerâmica, coloca as anotações do forno desta semana como post e conecta clayandkiln.com.

sw_create_world { handle: "clayandkiln", template_id: "glaze-good" }→ rascunho da casa criado
sw_create_post { kind: "note", title: "Kiln notes" }→ post adicionado
sw_prepare_domain { domain: "clayandkiln.com" }→ registros prontos para adicionar
sw_verify_domain→ aguardando o DNS

Exemplo Os nomes das ferramentas são os de verdade. Publicar continua sendo um passo à parte, que você pode pedir.

O que ele pode fazer

A casa inteira, do primeiro rascunho ao domínio no ar

Estas são algumas das 106 ferramentas que seu agente pode usar. Ele só vê as que as permissões do token liberam.

Criar e publicar casas
Escolhe uma casita, escreve os textos e links, mostra como ficou, publica e volta atrás se você mudar de ideia.
- sw_list_templates
- sw_get_template
- sw_create_world
- sw_update_world
- sw_get_world
- sw_preview_revision
- sw_publish_world
- sw_rollback_world
Escrever posts
Adiciona notas, links, imagens e projetos a uma casa, edita depois e define como a seção de posts aparece.
- sw_create_post
- sw_update_post
- sw_list_posts
- sw_update_posts_settings
- sw_delete_post
Conectar um domínio
Prepara seu domínio, entrega os registros DNS exatos para adicionar e confere até o certificado ficar pronto.
- sw_prepare_domain
- sw_prepare_dns_plan
- sw_get_dns_plan
- sw_verify_domain
- sw_get_domain
- sw_list_domains
Acompanhar seus nomes
Coloca na sua estante todos os domínios que você tem e conta quais renovam logo e quanto vão custar.
- sw_import_shelf_domains
- sw_list_shelf_domains
- sw_list_expiring_domains
- sw_get_shelf_summary
- sw_get_renewal_spend
Trazer seus links
Lê uma página de links que você já tem, mostra o que encontrou e adiciona só os links que você escolher.
- sw_extract_link_page
- sw_preview_profile_import
- sw_apply_profile_import
Leitores e mensagens
Configura o formulário de inscrição, mostra quem se inscreveu e o que os visitantes escreveram, prepara respostas e traz seus números.
- sw_update_audience_settings
- sw_list_subscriptions
- sw_list_inquiries
- sw_reply_inquiry
- sw_query_analytics
Muitos domínios de uma vez
Transforma uma lista de domínios em casas, primeiro com um teste. Nada roda até você aprovar o plano exato.
- sw_create_portfolio
- sw_prepare_bulk_plan
- sw_request_approval
- sw_execute_bulk_plan
- sw_get_bulk_run
- sw_pause_bulk_run
- sw_rollback_bulk_run

Conecte

Dois passos, poucos minutos

Crie um token

Entre na sua conta e abra Desenvolvedores no painel. Escolha Nova conexão, marque MCP, ative as permissões necessárias e copie o token. Ele aparece uma vez só e vale por até 90 dias.
Abrir Desenvolvedores
Adicione ao seu assistente

Cole uma destas configurações com seu token no lugar de sw_mcp_... e guarde o token nas configurações do app, não numa conversa.

Claude Code

Rode isto num terminal. Adicione --scope user para usar em todos os projetos.

claude mcp add --transport http mini-casa https://mini.casa/mcp \
  --header "Authorization: Bearer sw_mcp_..."

Claude Desktop

Adicione isto ao claude_desktop_config.json e reinicie o Desktop. Ele usa a ponte mcp-remote, então você precisa do Node.js.

{
  "mcpServers": {
    "mini-casa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.2",
        "https://mini.casa/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sw_mcp_..."
      }
    }
  }
}

Qualquer outro cliente MCP

Clientes que aceitam um servidor HTTP com cabeçalhos só precisam do endereço e do cabeçalho Authorization.

{
  "mcpServers": {
    "mini-casa": {
      "url": "https://mini.casa/mcp",
      "headers": {
        "Authorization": "Bearer sw_mcp_..."
      }
    }
  }
}

Os conectores personalizados do claude.ai e a tela de conectores do Claude Desktop entram com OAuth, que o Mini Casa ainda não oferece. Enquanto isso, use o Claude Code ou a ponte acima.

Endereço: https://mini.casa/mcp
Transporte: Streamable HTTP, protocolo 2026-07-28 e o handshake 2025-11-25 que os clientes atuais usam
Acesso: Authorization: Bearer e o seu token

Quem manda é você

Até onde um token chega, e até onde não

Um token pertence a um só espaço de trabalho. Se ele perguntar por outro, a resposta é como se esse espaço não existisse.
Ele nunca faz mais do que o seu próprio papel permite, e o seu papel é conferido de novo a cada chamada.
Você escolhe as permissões. As sensíveis, como endereços de inscritos ou cobrança, nunca vêm marcadas e pedem que você entre de novo antes.
Os tokens expiram em 30 dias, a menos que você escolha outro prazo, de no máximo 90.
Revogue um token na página Desenvolvedores e ele para na próxima requisição, inclusive o trabalho que estava na fila.
Textos escritos por visitantes, inscritos ou páginas importadas chegam ao seu agente marcados como dados não confiáveis, nunca como instruções.

O que um agente não pode fazer

Aprovar os próprios planos. Ele pode pedir; só quem é dono do espaço pode dizer sim, na página de revisão.
Gastar dinheiro. O pagamento devolve um link que uma pessoa conclui.
Mandar e-mail para alguém. Respostas a visitantes ficam salvas como rascunho para você enviar.
Apagar ou restaurar uma casa ou uma conta. Isso precisa de você, com login recente.
Gravar registros DNS no seu provedor. Isso está desligado por enquanto: seu agente prepara os registros e confere, e você os adiciona onde fica o seu DNS.
Entrar em outro espaço de trabalho ou nas casas de outra pessoa.

Bom saber

Perguntas frequentes

Ler a documentação para desenvolvedores

Como funciona a API para agentes

Quais assistentes funcionam?

Qualquer um que fale o Model Context Protocol por HTTP e consiga enviar um cabeçalho Authorization. O Claude Code funciona direto, o Claude Desktop pela ponte mcp-remote, e há uma API REST para os seus próprios scripts.

Conectar um agente custa a mais?

Não. Os tokens vêm com todo espaço de trabalho, inclusive no plano grátis; quem cria é um dono ou administrador. O agente tem os mesmos limites de plano que você, então o que o seu plano não inclui também fica fora do alcance dele.

Quais permissões devo dar?

Comece com as permissões padrão de leitura e acrescente o que o trabalho pedir: edição de casas para montar páginas, permissões de domínio para conectar um domínio. As ferramentas sem permissão nem aparecem para ele.

E se um token vazar?

Revogue na página Desenvolvedores e ele para de funcionar na próxima requisição. Do nosso lado fica guardado só um hash, então ninguém consegue ler o token de volta, e todo token expira em no máximo 90 dias.

Meu assistente pode relatar um bug para vocês?

Sim. Peça para ele enviar um feedback e ele vai usar sw_submit_feedback, que qualquer token pode chamar. O relato chega à nossa caixa de suporte com a sua conta, então podemos responder se você permitir. Antes de incluir algo pessoal, ele pergunta a você.

Tem uma API para o meu próprio código?

Tem. As mesmas operações formam uma API REST em /api/v1, descrita num documento OpenAPI. Escolha API REST em vez de MCP ao criar o token.

Crie uma casa

Pronto para um lugar só seu?

Escolha uma cena, adicione suas palavras e links e publique em um endereço gratuito da Mini Casa.

Crie sua casa Ver todos os recursos