Vai al contenuto principale
Tutte le guide MCP

Configurazione MCP

Usare Attorly con i modelli OpenAI

L'API di OpenAI può chiamare direttamente il server MCP di Attorly, così agenti e servizi basati su modelli OpenAI possono usarne gli strumenti per contratti, clausole e ricerca giuridica.

Prima di iniziare

  • Un piano Attorly Pro o Enterprise.
  • Una chiave API di OpenAI con accesso alla Responses API.

Le impostazioni dei connettori di ChatGPT aggiungono solo server che accedono con OAuth. Il server MCP di Attorly usa chiavi API, quindi si collega tramite l'API di OpenAI, come qui sotto, e non dalle impostazioni di ChatGPT.

Passaggi

  1. Crea una chiave

    Crea una chiave in Impostazioni › Sviluppatori e scegli OpenAI API. La pagina delle impostazioni mostra poi i passaggi qui sotto con la tua chiave già inserita.

    Crea una chiave per OpenAI API

  2. Aggiungi Attorly a OpenAI API

    Dai a un modello OpenAI gli strumenti di Attorly aggiungendo il server MCP a una richiesta all'API di OpenAI.

    Chiama la Responses API di OpenAI con Attorly come strumento

    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."
}'

    La stessa chiamata con la libreria Python di 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. Verifica che funzioni

    Esegui la richiesta. La risposta elenca gli strumenti Attorly chiamati dal modello e termina con la sua risposta. Le chiamate compaiono anche in Impostazioni › Sviluppatori › Registro delle richieste.

Se non funziona

La risposta contiene un errore per il server Attorly.
Verifica l'intestazione Authorization nella richiesta. I dettagli dell'errore, come un permesso mancante, sono nell'output MCP della risposta e nel tuo registro delle richieste.
Il modello non chiama Attorly.
Indica nell'input cosa vuoi da Attorly, per esempio «Usa Attorly per cercare nella libreria delle clausole…».
Qualcos'altro è andato storto.
Errori come 401, insufficient_scope e rate_limited sono spiegati nella sezione di risoluzione dei problemi MCP. Ogni chiamata compare anche in Impostazioni › Sviluppatori › Registro delle richieste, con l'errore restituito. Risoluzione dei problemi MCP

Altri client