cicora.ai
Especificação da APIFerramentas, recursos e prompts

MCP

Ligue um cliente de IA a ferramentas, recursos e prompts permitidos através de um URL de ligação emitido nas definições da conta.

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

Configurar uma ligação

Um cliente MCP recebe um URL de ligação e uma chave através de configuração segura. Não acrescente manualmente uma rota presumida: use o valor criado para a sua organização.

Um servidor apresenta ferramentas, recursos e prompts. O cliente deve mostrar ao utilizador que ação é pedida e que contexto será lido.

Configuração do cliente MCP
typescript
const connection = {
  url: process.env.CICORA_MCP_URL,
  headers: { Authorization: "Bearer " + process.env.CICORA_API_KEY },
};

// Use the connection URL issued in account API settings.

Permissões e execução

  • Separe leitura, escrita e execução ao nível da ferramenta.
  • Valide os parâmetros da ação no lado da integração antes da execução.
  • Mantenha, sem segredos, um registo da chamada, do executor e do resultado.

Ligar num produto

Isole cada ligação por organização e utilizador, para que uma chave não aceda a outro contexto.

Verifique as ferramentas disponíveis no momento da ligação e novamente após uma alteração de permissões, em vez de as guardar indefinidamente em cache.