Torne a sua aplicação conduzível por agentes em minutos
Escreve apenas uma coisa: a superfície. O SDK trata da ligação — transporte MCP, tokens bearer por instância, registo de instâncias, pedidos de consentimento, auditoria e o fluxo em direto. A sua aplicação apenas descreve o que sabe fazer e responde a um punhado de métodos.
Adicione o SDK, implemente a superfície, inicie o host
- Referencie os pacotes. Adicione as abstrações do App Use e o SDK ao seu projeto .NET.
- Implemente a superfície. Descreva os seus ecrãs e elementos e responda a read / get / set / invoke. A maioria dos métodos são linhas únicas sobre o seu estado existente.
- Inicie o host. Uma chamada no arranque regista a sua aplicação para que qualquer agente local — ou um hub — a possa encontrar.
Aloje-a — uma chamada
await using var host = await AppUseHost.StartAsync(
new AppUseHostOptions
{
AppId = "hello",
AppName = "Hello",
AppVersion = "1.0",
Surface = new HelloSurface(),
});
// The SDK writes an instance-registration file; a Hub
// watching the directory now sees your app and brokers
// it to any connected agent.
A superfície declara um AppSpec (ecrãs + elementos + ações) e responde a ReadScreenAsync, GetValueAsync, SetValueAsync, InvokeAsync e alguns métodos de navegação / janela. O SDK valida cada chamada face ao âmbito do token e ao pedido de consentimento antes de esta chegar ao seu código.
As partes difíceis estão tratadas
Transporte & autenticação
Servidor MCP SSE em loopback com um bearer cunhado por instância — nunca lida com a ligação diretamente.
Registo
É escrito um ficheiro de instância para que hubs e agentes descubram a sua aplicação automaticamente.
Consentimento & auditoria
As chamadas de escrita / execução passam pelo portão de consentimento e ficam no registo de auditoria encadeado por hash.
Observabilidade em direto
Cada chamada e resultado transmite para o fluxo de tap que uma consola de operador pode subscrever.
A documentação completa do SDK & a especificação estão a caminho
O guia de integração completo, a referência do contrato da superfície, os auxiliares do registo de elementos e a especificação completa do protocolo estão a ser preparados para publicação aberta. Quer acesso antecipado, o SDK ou ajuda na integração? Contacte-nos.