Fillo

Documentação · Guias · Agentes · Changelog

O servidor MCP Fillo. Ele dá a um agente de codificação o loop completo do Fillo — provisionar um workspace, criar a estrutura de um formulário no repositório do host, publicá-lo e consultar suas respostas — sem sair da sessão, autenticado exatamente como um usuário CLI humano.

Instalação

Um clique, se o seu editor suportar:

Claude Code:

claude mcp add fillo -- npx -y @usefillo/mcp

Qualquer outro cliente MCP: execute npx -y @usefillo/mcp via stdio. Defina FILLO_API para apontar para uma implantação que não seja de produção.

Credenciais

O servidor lê as mesmas credenciais que a CLI grava em ~/.fillo/config.json, ou do ambiente:

• FILLO_TOKEN — um fcli_… token de login (de npx @usefillo/cli login). Ferramentas autenticadas (fillo_list_forms, fillo_publish_form e pushes confiáveis para um workspace reivindicado), além da seleção local de projeto com um login comum. Pushes de solicitação de arquivo permanecem como rascunho/em estágio para revisão.
• FILLO_PK — uma chave publicável pk_…. fillo_provision_workspace gera uma e a salva para você.
• FILLO_API_KEY — uma chave de API de projeto fsk_…, gerada em Configurações → Conexões de um workspace reivindicado. Necessária para as ferramentas de resposta.
• FILLO_API — substitui a origem (padrão https://fillo.so).
• FILLO_CONFIG_DIR — substitui o diretório de configuração (padrão ~/.fillo).

O servidor nunca imprime tokens de login, chaves de API ou tokens de reivindicação na transcrição. A chave publicável pk_ é segura para expor (ela vive no código do navegador), então fillo_provision_workspace a retorna para você conectar no env público do aplicativo. O provisionamento também torna esse projeto temporário o contexto MCP local ativo, para que um login de conta salvo mais antigo não possa receber o próximo push. Selecionar um projeto muda o contexto de volta para a conta.

Ferramentas

Ferramenta	Autenticação	O que faz
fillo_provision_workspace	nenhuma (precisa de um e-mail)	Crie um workspace de pré-visualização não reivindicado, retorne sua chave pk_ e limites, e envie por e-mail o link de reivindicação.
fillo_whoami	token de login ou pk_	Relate a credencial ativa, o workspace e o projeto.
fillo_list_projects	token de login comum	Liste projetos no workspace atual e marque a seleção atual.
fillo_create_project	token de login comum	Crie e selecione um projeto isolado e salve sua chave pk_.
fillo_select_project	token de login comum	Selecione por id, slug ou nome exato único e atualize o estado local do projeto.
fillo_push_form	token de login ou pk_	Crie ou atualize um formulário a partir de um schema + handle; solicitações de arquivo permanecem como rascunho/em estágio até a publicação explícita.
fillo_publish_form	token de login	Coloque alterações em rascunho ou em estágio em produção após revisão; retorne o link exato de configuração de armazenamento quando bloqueado.
fillo_list_forms	token de login	Liste os formulários do projeto.
fillo_get_form	nenhuma (publicado)	Busque o schema, o tema e as capacidades de um formulário publicado.
fillo_search_examples	nenhuma	Pesquise na biblioteca de exemplos curada do Fillo.
fillo_docs	nenhuma	Busque uma página de documentação do Fillo como Markdown por tópico.
fillo_list_responses	chave de API fsk_	Liste as respostas de um formulário (somente workspaces reivindicados).
fillo_get_response	chave de API fsk_	Busque uma resposta (somente workspaces reivindicados).
fillo_response_summary	chave de API fsk_	Resuma as respostas de um formulário sem ler cada linha (somente workspaces reivindicados).
fillo_claim_status	pk_	Relate os limites do workspace provisionado e o prazo de reivindicação.

Não há ferramentas de exclusão. As anotações de escrita ainda usam a dica conservadora de pior caso, porque um push pode substituir o estado de rascunho e uma publicação pode substituir o schema público. Cada ferramenta é um wrapper fino sobre a API HTTP pública do Fillo — o servidor nunca toca no banco de dados e não importa código do aplicativo, então o escopo do workspace, os limites de taxa e a validação permanecem em um só lugar.

As três ferramentas de projeto são apenas locais e exigem o token geral gerado por fillo login. Uma transferência específica de projeto e uma concessão OAuth remota-MCP hospedada permanecem vinculadas ao projeto que um humano aprovou. Selecionar localmente também limpa o estado de pré-visualização em cache e fsk_ do projeto anterior; substitua você mesmo quaisquer substituições de ambiente FILLO_PK ou FILLO_API_KEY.

Projetos são sites/aplicativos sob um workspace faturado. Eles isolam formulários, chaves publicáveis/API, origens permitidas, identidades de respondentes e autoridade do agente. Associação ao workspace, faturamento, conexões de armazenamento e totais de uso permanecem compartilhados.

Links

• Documentação: fillo.so/docs
• Site: fillo.so

Licenciado sob MIT.