> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semantika.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Ligar o Claude.ai

> Cola só o URL MCP. Não cries token nem coles Client ID, Secret ou sem_mcp_….

O Claude entra com a tua conta Semantika. Basta **uma conta Semantika com pelo menos um workspace**. Não é preciso plano pago para ligar por OAuth. O plano pago só é exigido no método antigo de API key, que não é o usado pelo Claude.

Não cries um token. Não coles um Client ID, um Secret, nem um `sem_mcp_…`.

O **Claude Free chega** (1 custom connector).

## Passos

<Steps>
  <Step title="Copia o URL MCP">
    Na Semantika, **Definições → Geral**, campo **URL MCP**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Cola só o URL">
    Cola o URL MCP. Deixa **Advanced** e **OAuth Client ID** vazios. Clica **Add** e depois **Connect** — o Claude abre a Semantika no browser.
  </Step>

  <Step title="Autoriza os workspaces">
    Entra na Semantika se for preciso. No ecrã de consentimento, escolhe **um ou mais workspaces** e clica **Autorizar**.
  </Step>

  <Step title="Volta ao Claude">
    O conector fica ligado. A ligação aparece em **Definições → Geral → Conectores MCP**.
  </Step>
</Steps>

## O que precisas de saber

* Não coles um token `sem_mcp_…` no conector do Claude. Esse fluxo é iniciar sessão.
* O acesso fica limitado aos workspaces que escolheres no ecrã de consentimento.
* Para cortar o acesso, revoga o conector em **Definições → Geral**.

O ChatGPT usa o mesmo URL: [Ligar o ChatGPT](/mcp-reference/chatgpt). Para outros clientes MCP, usa um token: [Personal access token](/mcp-reference/token).

## Ferramentas disponíveis

Depois de ligado, o Claude pode usar estas ferramentas. São todas só de leitura.

| Ferramenta       | O que faz                                                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `list_brands`    | Lista as marcas dos workspaces autorizados, com o `brand_id` de cada uma. Chama-se primeiro; as outras precisam de um `brand_id`. |
| `get_visibility` | Share of Voice, taxa de citação, taxa de menção e sentimento (0–100) de uma marca, com detalhe por motor.                         |
| `list_actions`   | Ações recomendadas de uma marca, por prioridade. Filtros opcionais: estado, ordenação, limite.                                    |
| `get_action`     | Detalhe completo de uma ação: descrição, justificação, passos, impacto estimado e fontes.                                         |
| `get_report`     | Resumo da análise GEO mais recente: score snapshot e secções do último brief.                                                     |
| `list_prompts`   | Prompts monitorizados de uma marca, com visibilidade por motor, sentimento e citações.                                            |

## Exemplos

* "Lista as minhas marcas na Semantika."
* "Qual é o Share of Voice da marca X esta semana e o detalhe por motor?"
* "Que ações recomendadas tenho para a marca X?"
* "Mostra o relatório GEO mais recente da marca X."


## Related topics

- [Ligar o ChatGPT](/mcp-reference/chatgpt.md)
- [Tools MCP](/mcp-reference/tools.md)
- [Personal access token](/mcp-reference/token.md)
- [FAQ da Semantika: produto, planos, dados e conta](/help/faq.md)