Recursos
O SwiftXEO disponibiliza uma API REST delimitada ao espaço de trabalho, um servidor MCP com OAuth e webhooks de entrada assinados. Todas as operações de escrita funcionam apenas como propostas, ficando a aprovação reservada a utilizadores humanos autenticados.
Ligue o Claude, ChatGPT, Cursor ou o seu próprio sistema ao Business DNA aprovado, objetivos e aprendizagens ativas. Envie evidências e propostas através da mesma revisão humana aplicada a tudo o resto.
A regra fundamental
Um agente conectado via API ou MCP consulta o contexto aprovado para o qual a sua credencial tem permissão: Business DNA, aprendizagens ativas, objetivos e histórico de alterações. Pode sinalizar aspetos a rever e propor lições pertinentes. O que não pode fazer é assumir autonomamente que a sua conclusão está correta.
Nenhum nível de acesso, ferramenta ou payload de webhook pode aprovar ou ativar uma aprendizagem. Esse processo decorre dentro do SwiftXEO, por uma pessoa autorizada e sob as regras de revisão de destino. Ativar uma lição exige especificamente a intervenção de um administrador ou proprietário do espaço de trabalho.
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 contexto aprovado
Business DNA, aprendizagens ativas, objetivos e linhagem — o mesmo registo que o produto apresenta a um utilizador.
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_...
Snapshot do Business DNA, aprendizagens ativas, objetivos e linhagem
Pesquisa de descoberta no workspace sobre tópicos, palavras-chave, campanhas, briefs e concorrentes
Propor aprendizagens — entra sempre como PENDING na fila de revisão humana
Submeter evidências, sinais ou documentos como contexto conectado
Geração supervisionada de conteúdo — deduz créditos do espaço de trabalho
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.
Snapshot do Business DNA aprovado — retornado através de uma projeção delimitada por allowlist
Aprendizagens ativas (aprovadas por humanos), com filtro por tipologia
Objetivos de crescimento em aberto
Evidências, histórico de revisões e aprovação humana de uma entidade
Propor uma aprendizagem — estado PENDING até validação humana
Submeter contexto conectado para revisão
Geração supervisionada de conteúdo, condicionada a créditos. Utilize persist: true para guardar o resultado como rascunho associado à proveniência do fornecedor/tarefa; caso contrário, devolve apenas o texto
Para trabalhos externos prolongados, o SwiftXEO pode emitir uma atribuição delimitada associada a um objetivo, receber o trabalho resultante e ligar observações posteriores ao mesmo registo.
Compilar uma atribuição de contexto delimitada para um objetivo autorizado — o formato delimitado a partir do qual um agente externo trabalha
Submeter trabalho referente a uma atribuição — rascunho, evidência ou proposta de aprendizagem — ficando pendente de revisão humana. A ligação entre atribuição e resultado é validada no servidor, sendo rejeitados IDs de atribuição inválidos ou inventados
Reportar uma observação qualitativa ou métrica relativamente ao resultado de um objetivo, de forma idempotente e sujeita a revisão humana
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..." \
-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 stateless com suporte a streaming. Atualmente, os clientes alojados testados incluem o Claude (web, desktop, mobile) e o ChatGPT, que se conectam via OAuth: cole o URL, inicie sessão, escolha um workspace, aprove o acesso. Clientes com ficheiro de configuração, como o Claude Code e o Cursor, utilizam uma chave estática de workspace.
A lista de ferramentas é filtrada de acordo com os âmbitos da ligação: as ferramentas de leitura devolvem contexto aprovado, as ferramentas de escrita apenas propõem. Não existe deliberadamente 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_k_xxxxxxxxxxxx_..."
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
As atualizações de rascunhos permanecem apenas como mutações de rascunho. Uma revisão externa não pode aprovar, autorizar, bloquear ou publicar o artefacto, e um rascunho revisto deve passar por uma nova revisão antes de poder avançar.
Limites
Uma chave de API ou ligação MCP/OAuth concede acesso de entrada e delimitado à API REST e ferramentas do SwiftXEO — nada mais. Não regista quem faz a chamada como membro da equipa do Agent Room e nunca concede visibilidade de @menção dentro do Agent Room de um espaço de trabalho.
Os elementos do Agent Room pertencem a uma lista fixa e dedicada: Claude, OpenAI, Gemini, o SwiftXEO Advisor e o Verifier. Cada um dispõe de regras próprias de encaminhamento e acesso que nenhuma credencial externa pode alargar ou contornar.
O protocolo Local Connector é complementar, mas autónomo. Emparelha um ambiente de execução local, como um Mac a executar tarefas do Agent Room, com as suas próprias credenciais, concessões e ciclo de revogação. Este processo é independente quer das chaves de API, quer das ligações MCP.
Webhooks de entrada
Crie uma fonte de entrada em Definições → Infraestrutura → Fontes de Entrada para receber um endpoint por fonte e um segredo de assinatura. Cada payload é verificado com HMAC-SHA256 sobre o corpo bruto antes de ser registado como contexto conectado — material para revisão humana, nunca a verdade por si só. A falha na verificação rejeita o pedido antes que algo seja analisado ou guardado.
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 marcar uma proposta como aprovada ou aceder a endpoints de aprovação. Os sistemas externos podem ler o contexto aprovado, adicionar evidências e propor aprendizagens. Cada proposta é registada como pendente, e a ativação de uma aprendizagem requer a autenticação de um administrador ou proprietário do espaço de trabalho.
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 plano Growth contempla leituras: Business DNA, objetivos, aprendizagens ativas, rastreabilidade e pesquisa no espaço de trabalho, além de uma fonte de webhook de entrada. O plano Execution acrescenta permissões de escrita: submissão de aprendizagens, envio de evidências, geração supervisionada de conteúdo e múltiplas origens de webhooks 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 encontra-se disponível na documentação. A página da Open Platform detalha o modelo de revisão aplicado por estes endpoints.