Vai al contenuto principale
Tutte le guide MCP

Configurazione MCP

Usa Attorly con l’API 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.

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 OpenAI, con la tua chiave nell’header Authorization.

    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