> ## 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.

# Model Context Protocol (MCP)

> O MCP permite que os LLMs interajam com a Semantika e obtenham contexto em tempo real.

A Semantika suporta o **Model Context Protocol (MCP)**, que funciona de forma muito semelhante à nossa API, mas foi desenhado especificamente para servir como contexto para Large Language Models (LLMs) como o Claude, Cursor, entre outros.

Através do MCP, pode conectar o seu assistente de IA diretamente à sua conta Semantika, permitindo que ele obtenha dados e insights relevantes para o ajudar nas suas tarefas diárias.

## Como Conectar

Para aceder ao servidor MCP da Semantika, precisa de configurar o seu cliente MCP com os seguintes dados:

* **Autenticação:** É necessária uma **API KEY** válida associada à sua conta Semantika.
* **Endpoint / Comando:** A ligação deve ser efetuada apontando para a rota `/mcp`.

## Ferramentas Disponíveis (Tools)

O nosso servidor MCP expõe um conjunto de ferramentas nativas que o LLM pode invocar para obter dados sobre a sua marca. As ferramentas atualmente disponíveis são:

<CardGroup cols={2}>
  <Card title="ListBrandsTool" icon="list">
    Lista todas as marcas associadas ao seu workspace. Útil para obter os
    identificadores (IDs) das marcas.
  </Card>

  <Card title="GetBrandVisibilityTool" icon="eye">
    Devolve o score de visibilidade (Brand Visibility) atual de uma marca
    específica.
  </Card>

  <Card title="GetActionDetailTool" icon="circle-info">
    Permite obter os detalhes completos e informações associadas a uma ação
    específica.
  </Card>

  <Card title="ListRecommendedActionsTool" icon="lightbulb">
    Lista as ações recomendadas pelo motor de IA da Semantika para melhorar o
    seu posicionamento.
  </Card>

  <Card title="ListMonitoredPromptsTool" icon="terminal">
    Apresenta a lista de prompts e pesquisas que estão a ser ativamente
    monitorizadas.
  </Card>

  <Card title="GetLatestReportTool" icon="file-lines">
    Obtém as informações e insights do relatório mais recente gerado para a sua
    marca.
  </Card>
</CardGroup>

***

<Note>
  A integração via MCP exige que configure corretamente as variáveis de ambiente
  ou os argumentos do seu cliente de IA, assegurando que o parâmetro com a API
  KEY é enviado na ligação à rota `/mcp`.
</Note>