MCP da Semantika - Semantika

O assistente consulta as marcas, a visibilidade, as ações, os relatórios e os prompts dos workspaces que autorizares. Funciona no Claude, no ChatGPT, no Cursor e noutros clientes MCP. Só leitura: nunca altera nada na conta.

O que precisas

Basta uma conta Semantika com pelo menos um workspace. O URL MCP:

https://app.semantika.pt/mcp

Também está em Definições → Geral (só o owner vê). Há dois modos. Não os mistures.

Modo	Para quem	O que colas	Workspaces
Iniciar sessão (OAuth)	Claude.ai e ChatGPT.	Só o URL MCP. Sem Client ID, Secret ou token.	Os que autorizares no consentimento (podes ser mais do que um).
Personal access token	Cursor, Claude Desktop e outros clientes MCP que enviem um header `Authorization: Bearer sem_mcp_…`.	Token `sem_mcp_…`	Só o workspace onde o token foi criado.

O OAuth só está aberto ao Claude.ai e ao ChatGPT; os outros clientes usam token. Depois de Connect a Semantika abre no browser: escolhe um ou mais workspaces e clica Autorizar. Qualquer membro pode autorizar; só o owner vê e revoga a ligação em Definições → Geral → Conectores MCP.

Claude.ai

Serve para o Claude na web e na app de desktop.

Abre o conector no Claude

No Claude, vai a Customize → Connectors. Clica + e depois Add custom connector.Em planos Team ou Enterprise, um owner adiciona primeiro em Organization settings → Connectors → Add → Custom → Web.

Cola só o URL

Cola o URL MCP. Deixa Advanced e OAuth Client ID vazios. Clica Add e depois Connect.

ChatGPT

Liga o Developer Mode antes de criar o conector. Normalmente exige plano pago.

Liga o Developer Mode

No ChatGPT, clica na foto de perfil, vai a Settings → Security e liga o Developer Mode. Depois Settings → Connectors → Create.

Cola o URL e escolhe OAuth

Cola o URL MCP. Se o ChatGPT perguntar como autenticar, escolhe OAuth — não um token.

Outros clientes

Usa o token quando o cliente pede uma credencial em vez de abrir a Semantika no browser.

Cria o token

Na Semantika, Definições → Geral (só o owner), cria um personal access token. O sem_mcp_… aparece uma vez — copia já. Só expira quando o revogares.

Configura o cliente

Cola o token no cliente. Nas Definições há um snippet pronto a copiar, já com o URL preenchido.

Muitos clientes usam um JSON deste género (no Cursor: .cursor/mcp.json no projeto ou ~/.cursor/mcp.json):

{
  "mcpServers": {
    "semantika": {
      "url": "https://app.semantika.pt/mcp",
      "headers": {
        "Authorization": "Bearer sem_mcp_…"
      }
    }
  }
}

Revogar

Em Definições → Geral (só o owner):

Conectores MCP — a ligação do Claude ou do ChatGPT deixa de ter acesso no pedido seguinte, em todos os workspaces que tinha autorizado.
Personal access token — o sem_mcp_… deixa de funcionar de imediato.

Ferramentas

Depois de ligado, o assistente usa as ferramentas MCP. São todas só de leitura.

​O que precisas

​Claude.ai

​ChatGPT

​Outros clientes

​Revogar

​Ferramentas