Cala

MCP

Conecte seu agente de IA ao MCP da Cala

https://api.cala.ai/mcp/

Para mais informações sobre MCP e como ele funciona, você pode ler mais aqui.

Nota

Combine com a skill do agente. O servidor MCP dá ao seu agente acesso às ferramentas da Cala. A skill do agente dá a ele o conhecimento para usá-las bem. Instale ambos para a experiência completa.

Conecte seu agente ao MCP da Cala

Você pode usar a Cala por meio do nosso MCP. Para começar, você precisa obter uma chave de API para autenticar seu cliente MCP. Acesse nosso Console e crie uma nova chave de API.

Crie uma conta gratuita na Cala e obtenha sua chave de API.

Com sua chave de API em mãos, você pode conectar seu agente de IA, como Cursor, Claude Code e outros, ao nosso servidor MCP. O MCP da Cala dá aos agentes de IA acesso a conhecimento verificado, estruturado e tipado — tanto como respostas em linguagem natural quanto como dados estruturados — além de informações sobre entidades.

Adicione ao `~/.cursor/mcp.json`:

```json theme={null}
{
    "mcpServers": {
        "Cala": {
            "url": "https://api.cala.ai/mcp/",
            "headers": {
                "X-API-KEY": "YOUR_CALA_API_KEY"
            }
        }
    }
}
```

Para mais informações, siga a documentação deles [aqui](https://cursor.com/docs/context/mcp#installing-mcp-servers).

Adicione ao `.vscode/mcp.json`:

```json theme={null}
{
    "servers": {
        "Cala": {
            "type": "http",
            "url": "https://api.cala.ai/mcp/",
            "headers": {
                "X-API-KEY": "YOUR_CALA_API_KEY"
            }
        }
    }
}
```

Para mais informações, siga a documentação deles [aqui](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)

O Claude Desktop usa OAuth, então você não precisa de uma chave de API.

No Claude Desktop, vá em **Customize → Connectors → Add → Browse connectors**, procure por Cala e clique em **Connect to Claude**.

<img src="https://mintcdn.com/calaai/WSudIyxF6Merq2Gf/images/claude-desktop-directory.png?fit=max&auto=format&n=WSudIyxF6Merq2Gf&q=85&s=455569d1960f6eb0156ed629edbf247c" alt="Claude Desktop Directory" width="1900" height="1096" data-path="images/claude-desktop-directory.png" />

Uma **aba do navegador** será aberta para você fazer login na sua conta da Cala. Após **autorizar**, volte ao Claude Desktop e abra o conector da Cala para confirmar que todas as ferramentas estão habilitadas. Se não estiverem, habilite-as manualmente.

Para instalar a Cala como um **conector** do Claude, execute o seguinte comando no seu terminal adicionando sua chave de API:

```text theme={null}
claude mcp add --transport http cala https://api.cala.ai/mcp/   --header "X-API-KEY: YOUR_CALA_API_KEY"
```

Você também pode instalar a Cala como um **plugin**; ele faz parte do [marketplace comunitário](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json) de plugins do Claude. O plugin da Cala para Claude Code inclui nosso servidor MCP remoto, bem como a skill, para que o Claude Code possa usar as ferramentas MCP de forma otimizada.

Para isso, execute o seguinte no seu terminal do Claude Code para instalar o marketplace comunitário:

```text theme={null}
/plugin marketplace add anthropics/claude-plugins-community
```

Em seguida, instale o plugin da Cala:

```text theme={null}
/plugin install cala@claude-community
```

Execute isto para ativar o plugin:

```text theme={null}
/reload-plugins
```

Adicione ao `~/.vibe/config.json`:

```json theme={null}
{
  "mcpServers": {
    "Cala": {
      "url": "https://api.cala.ai/mcp",
      "headers": {
        "X-API-KEY": "YOUR_CALA_API_KEY"
      }
    }
  }
}
```

Adicione ao `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.cala]
enabled = true
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://api.cala.ai/mcp",
  "--header",
  "X-API-Key:${CALA_API_KEY}"
]

[mcp_servers.cala.env]
CALA_API_KEY = "YOUR_CALA_API_KEY"
```

> **Nota** > > Para suportar todo o poder do esquema flexível do nosso grafo, este servidor MCP utiliza objetos JSON dinâmicos. Isso proporciona uma experiência "sem esquema" para o LLM. Por causa disso, ele é incompatível com o "modo estrito" da OpenAI, então certifique-se de que `strict: false` esteja definido na sua especificação da OpenAI.

Para mais informações, siga a documentação deles [aqui](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

Para clientes com suporte remoto a MCP integrado:

```json theme={null}
{
    "mcpServers": {
        "Cala": {
            "url": "https://api.cala.ai/mcp/",
            "headers": {
                "X-API-KEY": "YOUR_CALA_API_KEY"
            }
        }
    }
}
```

Para clientes sem suporte remoto a MCP integrado:

```json theme={null}
{
    "mcpServers": {
        "Cala": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api.cala.ai/mcp/",
                "--header",
                "X-API-KEY: YOUR_CALA_API_KEY"
            ]
        }
    },
}
```

Ferramentas Disponíveis

Aqui estão as ferramentas disponíveis para o MCP da Cala:

Obtenha uma resposta sucinta e otimizada em tokens, em markdown de linguagem natural, com fontes, explicabilidade e entidades correspondentes. Aceita como entrada uma pergunta em linguagem natural ou uma expressão Cala QL. Obtenha conhecimento verificado como linhas JSON estruturadas e tipadas, além de entidades correspondentes. Aceita como entrada uma expressão Cala QL ou uma pergunta em linguagem natural. Pesquise entidades por nome com correspondência difusa. Obtenha o esquema de campos de uma entidade pelo seu UUID. Retorna as propriedades disponíveis, relacionamentos e observações numéricas que você pode usar ao consultar uma entidade. Recupere informações sobre uma entidade pelo seu UUID.

Hubs e Marketplaces

Você também pode encontrar o servidor MCP da Cala listado nos seguintes hubs e marketplaces:

Navegue pela listagem do servidor MCP da Cala no mcpservers.org. Navegue pela listagem do servidor MCP da Cala no mcp.so.