Saltar para o conteúdo principal
Todos os guias MCP

Configuração MCP

Usar o Attorly com modelos da OpenAI

A API da OpenAI pode chamar diretamente o servidor MCP do Attorly, para que agentes e serviços baseados em modelos da OpenAI usem as ferramentas para contratos, cláusulas e pesquisa jurídica.

Antes de começar

  • Um plano Attorly Pro ou Enterprise.
  • Uma chave de API da OpenAI com acesso à Responses API.

As definições de conectores do ChatGPT só adicionam servidores que iniciam sessão com OAuth. O servidor MCP do Attorly usa chaves de API, por isso liga-se através da API da OpenAI, como abaixo, e não pelas definições do ChatGPT.

Passos

  1. Criar uma chave

    Crie uma chave em Definições › Programadores e escolha OpenAI API. A página de definições mostra depois os passos abaixo com a sua chave já preenchida.

    Criar uma chave para OpenAI API

  2. Adicionar o Attorly a OpenAI API

    Dê a um modelo da OpenAI as ferramentas do Attorly adicionando o servidor MCP a um pedido à API da OpenAI.

    Chame a Responses API da OpenAI com o Attorly como ferramenta

    bash
    curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-5.5",
  "tools": [
    {
      "type": "mcp",
      "server_label": "attorly",
      "server_url": "https://attorly.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer lbmcp_your_api_key"
      },
      "require_approval": "never"
    }
  ],
  "input": "List my five most recent documents in Attorly and summarise the riskiest one."
}'

    A mesma chamada com a biblioteca Python da OpenAI

    python
    from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.5",
    tools=[{
        "type": "mcp",
        "server_label": "attorly",
        "server_url": "https://attorly.ai/api/mcp",
        "headers": {"Authorization": "Bearer lbmcp_your_api_key"},
        "require_approval": "never",
    }],
    input="List my five most recent documents in Attorly and summarise the riskiest one.",
)
print(response.output_text)

  3. Verificar se funciona

    Execute o pedido. A resposta lista as ferramentas do Attorly que o modelo chamou e termina com a sua resposta. As chamadas aparecem também em Definições › Programadores › Registo de pedidos.

Se não funcionar

A resposta contém um erro para o servidor do Attorly.
Verifique o cabeçalho Authorization no pedido. Os detalhes do erro, como um âmbito em falta, estão na saída MCP da resposta e no seu registo de pedidos.
O modelo não chama o Attorly.
Diga na entrada o que quer do Attorly, por exemplo «Usa o Attorly para pesquisar na biblioteca de cláusulas…».
Correu mal outra coisa.
Erros como 401, insufficient_scope e rate_limited são explicados na secção de resolução de problemas MCP. Cada chamada aparece também em Definições › Programadores › Registo de pedidos, com o erro devolvido. Resolução de problemas MCP

Outros clientes