August MCP

O August disponibiliza um servidor público do Model Context Protocol (MCP) em /api/mcp no aplicativo web do August em que você faz login. Aponte qualquer cliente MCP compatível com Streamable HTTP para esse endpoint e autentique-se com uma chave de API do August ou um token de acesso OAuth. Isso é o oposto de Suporte a MCP, que aborda a conexão do August com outros servidores MCP como cliente.

O endpoint

O servidor MCP funciona por meio de Streamable HTTP, portanto seu cliente se conecta diretamente a /api/mcp no aplicativo web do August, sem necessidade de configurar um transporte separado.

1. No seu cliente MCP, adicione um novo servidor MCP remoto e defina a URL como /api/mcp no aplicativo web do August.

2. Escolha como o cliente será autenticado: uma chave de API do August ou um token de acesso OAuth.

Autenticar com uma chave de API

Uma chave de API do August identifica sua conta de usuário e é a maneira mais simples de conectar um cliente sob seu controle.

1. Nas configurações da sua conta do August, abra a aba API Keys e crie uma chave. As chaves começam com ak_ e têm escopo definido para sua conta de usuário, portanto uma chave no nível da organização não funcionará aqui.

2. Configure seu cliente MCP para enviar a chave no cabeçalho Authorization como um token bearer: Authorization: Bearer ak_....

Autenticar com OAuth

Se, em vez disso, seu cliente fizer login por meio do OAuth, ele usará um token de acesso OAuth como token bearer no mesmo cabeçalho Authorization. O fluxo OAuth exige o escopo email.

Descoberta do OAuth

Clientes compatíveis com a descoberta do OAuth podem encontrar o servidor de autorização automaticamente. Se um cliente se conectar sem credenciais, o endpoint responderá com um desafio de autorização que aponta para os metadados do recurso protegido em /.well-known/oauth-protected-resource/api/mcp. Esse documento está disponível publicamente e informa a um cliente compatível onde iniciar o fluxo OAuth; portanto, não é necessário configurar manualmente o servidor de autorização.

Quais ferramentas estão disponíveis

O servidor MCP expõe a superfície pública da API do August como ferramentas MCP, para que seu cliente possa usar as operações públicas disponibilizadas, em vez de uma lista de ferramentas mantida separadamente. As mesmas operações estão disponíveis por meio da API REST; consulte API do August. As áreas abrangidas incluem projetos, pastas, documentos, chats, pesquisa jurídica, fluxos de trabalho, skills, tags, pesquisa e uploads.

Os nomes das ferramentas seguem os caminhos dos procedimentos da API. Por exemplo, a operação da API pública projects.list é exposta como projects_list.