Recursos
O SwiftXEO expõe uma API REST com âmbito de workspace, um servidor MCP com OAuth e webhooks de entrada assinados — cada superfície de escrita é apenas para propor e a aprovação cabe a humanos com sessão iniciada.
Conecte o Claude, ChatGPT, Cursor ou um sistema personalizado ao DNA de Negócio aprovado, objetivos e aprendizagens ativas — e contribua com evidências e propostas através da mesma revisão humana que governa tudo o resto.
Doutrina principal
Um agente conectado através da API ou MCP pode ler tudo o que o seu workspace aprovou e realizar um trabalho útil fundamentado nisso. Pode observar elementos que valem a pena rever e propor uma lição que valha a pena aprender. O que não pode fazer é decidir que a sua própria conclusão está correta.
Nenhum âmbito, ferramenta ou payload de webhook pode aprovar ou ativar uma aprendizagem. Essa decisão ocorre uma única vez, dentro do produto, por um administrador de workspace — o mesmo filtro por onde passa cada proposta gerada internamente.
Princípios da Plataforma Aberta
Acesso vinculado a credenciais
O workspace é derivado da chave. Não pode ser selecionado nem sobreposto por um parâmetro de pedido.
Ler a verdade aprovada
DNA de Negócio, aprendizagens ativas, objetivos e histórico de decisões — o mesmo registo que o produto mostra a um humano.
Propor, nunca aprovar
As escritas externas ficam pendentes. Nenhum âmbito alcança a rota de autorização.
Recolha de evidências assinada
Os payloads de webhook são verificados por HMAC e armazenados como contexto conectado para revisão — nunca executados.
Não confiável por predefinição
O material externo é assinalado como não confiável na ingestão. A promoção é sempre uma decisão humana.
Projetado, não em bruto
As respostas são projeções baseadas numa lista de permissões. Os identificadores internos permanecem no interior; os revisores surgem como rótulos de função e não com nomes.
Autenticação
Crie uma chave de API de workspace em Definições → Infraestrutura → Acesso à Plataforma Aberta (requer administrador de workspace). O segredo é exibido uma única vez; apenas a sua hash é guardada. Os âmbitos de leitura estão incluídos no plano Growth; os âmbitos de escrita exigem o plano Execution e são verificados novamente no momento da utilização, para que uma alteração de plano tenha efeito no pedido seguinte.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Instantâneo do DNA de Negócio, aprendizagens ativas, objetivos e histórico de decisões
Pesquisa de descoberta no workspace sobre tópicos, palavras-chave, campanhas, briefs e concorrentes
Propor aprendizagens — fica sempre PENDENTE na fila de revisão humana
Submeter evidências, sinais ou documentos como contexto conectado
Geração de conteúdo governado — deduz créditos do workspace
Growth = consumir orientação aprovada · Execution = contribuir para o fluxo de trabalho governado
API REST v1
Cada resposta utiliza a mesma estrutura — { data, meta? } em caso de sucesso, { error: { code, message } } em caso de erro. As leituras estão limitadas a 60 pedidos por minuto por workspace e as escritas a 20. A geração deduz créditos do workspace antes da chamada ao modelo.
Instantâneo do DNA de Negócio aprovado — uma projeção da verdade organizacional por lista de permissões
Aprendizagens aprovadas por humanos (ativas), filtráveis por tipo
Objetivos de crescimento em aberto
Evidências, histórico de revisões e autorização humana para uma entidade
Propor uma aprendizagem — PENDENTE até aprovação humana
Submeter contexto conectado para revisão
Geração de conteúdo governado, sujeito a créditos
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "content_learnings",
"category": "overclaim",
"lesson": "Avoid absolute performance claims without evidence.",
"evidenceNote": "Three campaign replies flagged the launch copy as overstated."
}'Servidor MCP
O endpoint /api/mcp comunica via HTTP com suporte a streaming e sem estado (stateless). Clientes alojados — Claude na web, desktop e mobile, e ChatGPT em modo de programador — conectam-se via OAuth: cole o URL, inicie sessão, escolha um workspace e aprove o acesso. Clientes baseados em ficheiros de configuração, como o Claude Code e o Cursor, utilizam uma chave estática do workspace.
A lista de ferramentas é filtrada de acordo com os âmbitos da ligação: as ferramentas de leitura devolvem a verdade aprovada, as ferramentas de escrita apenas propõem. Deliberadamente, não existe nenhuma ferramenta para aprovar, ativar ou autorizar em qualquer âmbito.
Claude Code, Cursor e outros clientes baseados em ficheiros de configuração
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
Claude na web, Desktop, mobile e ChatGPT
Adicionar conector personalizado URL: https://www.swiftxeo.com/api/mcp → Inicie sessão no SwiftXEO, escolha um workspace, aprove o acesso. Sem chave para colar — esta ligação utiliza OAuth.
Ferramentas disponíveis
Webhooks de entrada
Crie uma fonte de entrada em Definições → Infraestrutura → Fontes de Entrada para receber um endpoint por fonte e o respetivo segredo de assinatura. Cada payload é verificado com HMAC-SHA256 sobre o corpo em bruto antes de ser guardado como contexto conectado — material para revisão humana, nunca uma verdade por si só.
O plano Growth inclui uma fonte ativa; o plano Execution permite múltiplas fontes.
POST /api/hooks/{workspaceId}/{sourceId}
X-Signature: sha256=<hmac of raw body>
{
"kind": "signal",
"title": "CRM: deal closed",
"body": "Acme signed the annual
plan after the Q3 campaign."
}Perguntas
Não. Nenhum âmbito de API, ferramenta MCP ou webhook pode alterar uma proposta para aprovada ou aceder à rota de autorização. Os sistemas externos podem ler a verdade aprovada, contribuir com evidências e propor aprendizagens — cada proposta fica pendente e apenas um administrador de workspace com sessão iniciada como utilizador humano a pode aprovar.
Dois tipos de credenciais no mesmo cabeçalho bearer: uma chave de API estática do workspace para clientes com ficheiro de configuração ou um token de acesso OAuth para clientes alojados como o Claude e o ChatGPT. Em ambos os casos, o workspace deriva da credencial — nunca de argumentos da ferramenta.
O Growth cobre leituras: DNA de Negócio, objetivos, aprendizagens ativas, histórico e pesquisa no workspace, além de uma fonte de webhook de entrada. O Execution adiciona escritas: proposição de aprendizagens, submissão de evidências, geração de conteúdo governado e múltiplas fontes de entrada.
Apenas rótulos de função. As respostas externas são projetadas através de uma camada de ocultação: as identidades de revisores e autores passam a "Administrador do Workspace" e os identificadores internos são removidos antes de qualquer dado sair do workspace.
A referência completa da plataforma está disponível na documentação, e a página Plataforma Aberta explica o modelo de governança aplicado por estes endpoints.