Ves al contingut principal
Totes les guies d'MCP

Guia de configuració d'MCP

Fes servir Attorly amb l'API d'OpenAI

L'API d'OpenAI pot cridar directament el servidor MCP d'Attorly, de manera que els agents i els back-ends construïts sobre models d'OpenAI poden fer servir les seves eines per a contractes, clàusules i recerca jurídica.

Abans de començar

  • Un pla Pro o Enterprise d'Attorly.
  • Una clau d'API d'OpenAI amb accés a l'API Responses.

Passos

  1. Crea una clau

    Crea una clau a Configuració › Desenvolupadors i tria OpenAI API. La pàgina de configuració mostra llavors els passos següents amb la teva clau ja emplenada.

    Crea una clau per a OpenAI API
  2. Afegeix Attorly a OpenAI API

    Dona a un model d'OpenAI les eines d'Attorly afegint el servidor MCP a una sol·licitud de l'API d'OpenAI, amb la teva clau a la capçalera Authorization.

    Crida l'API Responses d'OpenAI amb Attorly com a eina

    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 mateixa crida amb la biblioteca Python d'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. Comprova que funciona

    Executa la sol·licitud. La resposta llista les eines d'Attorly que ha cridat el model i acaba amb la seva resposta. Les crides també apareixen a Configuració › Desenvolupadors › Registres de sol·licituds.

Si no funciona

La resposta conté un error del servidor d'Attorly.
Comprova la capçalera Authorization de la sol·licitud. Els detalls de l'error, com un permís que falta, són a la sortida MCP de la resposta i al teu registre de sol·licituds.
El model no crida Attorly.
Digues a l'entrada què vols d'Attorly, per exemple: «Fes servir Attorly per cercar a la biblioteca de clàusules…».
Hi ha hagut un altre problema.
Els errors com 401, insufficient_scope i rate_limited s'expliquen a la secció de resolució de problemes d'MCP. Cada crida també apareix a Configuració › Desenvolupadors › Registres de sol·licituds, amb l'error que ha retornat. Resolució de problemes d'MCP

Altres clients