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
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 APIAggiungi 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
bashcurl 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
pythonfrom 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)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