Integrações

Model Context Protocol (MCP)

O MCP é um protocolo aberto para expor ferramentas e contexto a assistentes e IDEs. O OpenSync expõe um servidor MCP por space, para que o teu agente possa listar, ler, escrever e pesquisar ficheiros na cloud com o mesmo modelo de versões que a app web. Especificação: modelcontextprotocol.io.

Transporte e URL

O endpoint usa Streamable HTTP (POST para pedidos JSON-RPC e GET opcional para SSE). Substitui <space_id> pelo identificador do cofre (o mesmo que vês na URL do workspace, por exemplo /dashboard/spaces/…).

Base da API nesta build: https://api.opensync.space/api (configura NEXT_PUBLIC_API_URL se self-host).

text

https://api.opensync.space/api/agent/spaces/<space_id>/mcp

Autenticação

Cada pedido MCP deve incluir um token de agente no cabeçalho Authorization: Bearer …. O token começa por osk_ e está ligado a esse space.

Na app: abre o space → modo editor → botão MCP na barra lateral.
Cola um token osk_ existente ou usa Gerar novo token (mostrado uma vez — guarda-o em local seguro).
Copia o bloco JSON sugerido no painel (equivalente ao exemplo abaixo) para o ficheiro de configuração do teu cliente MCP.

Exemplo de configuração

Formato alinhado com o painel "Conexão MCP" da app (nome do servidor pode ser o que preferires):

json

{
  "mcpServers": {
    "opensync-space": {
      "type": "streamable-http",
      "url": "https://api.opensync.space/api/agent/spaces/<space_id>/mcp",
      "headers": {
        "Authorization": "Bearer <osk_token>"
      }
    }
  }
}

Ferramentas expostas

O servidor MCP regista-se como opensync-space e oferece:

list_files — árvore de ficheiros com versão e tamanho.
read_file — conteúdo UTF-8 de um caminho.
write_file — criar ou substituir (concorrência com versão base).
delete_file — apagar por caminho.
rename_file — mover/renomear dentro do space.
search_files — pesquisa por nome ou conteúdo.

Voltar à visão geral da documentação.