OpenAI API

OpenAI Responses API se poate conecta direct la serverele MCP de la distanță. Transferați punctul final al platformei și tokenul OAuth ca un instrument MCP; nu traduceți instrumentele MCP în rute REST personalizate.

Atenție

Modelul poate accesa instrumentele platformei permise de tokenul și cererea dvs. Restricționați lista de instrumente și solicitați aprobarea pentru orice operațiune care poate schimba datele de conformitate.

Prerequisites

• An OpenAI API key
• Acces la o instanță a platformei
• A scoped the platform OAuth token
• O versiune recentă a OpenAI Python sau JavaScript SDK

Endpoint

Alegeți punctul final pentru mediul dvs. de platformă:

Environment	MCP URL
the platform US	https://us.probo.com/api/mcp/v1
the platform EU	https://eu.probo.com/api/mcp/v1
Custom	https://your-probo-instance.com/api/mcp/v1

The /v1 segment is required.

Example

Instalați SDK-ul și setați ambele credențiale:

Python

pip install --upgrade openai
export OPENAI_API_KEY="your_openai_api_key"
export PROBO_API_TOKEN="your_probo_api_token"

JavaScript

npm install openai
export OPENAI_API_KEY="your_openai_api_key"
export PROBO_API_TOKEN="your_probo_api_token"

Apelați la un instrument de platformă doar pentru citire prin intermediul răspunsurilor API:

Python

import os
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6",
    input="List the Probo organizations I can access.",
    tools=[
        {
            "type": "mcp",
            "server_label": "probo",
            "server_description": "Probo compliance management",
            "server_url": "https://us.probo.com/api/mcp/v1",
            "authorization": os.environ["PROBO_API_TOKEN"],
            "allowed_tools": ["listOrganizations"],
            "require_approval": "never",
        }
    ],
)

print(response.output_text)

JavaScript

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-5.6",
  input: "List the Probo organizations I can access.",
  tools: [
    {
      type: "mcp",
      server_label: "probo",
      server_description: "Probo compliance management",
      server_url: "https://us.probo.com/api/mcp/v1",
      authorization: process.env.PROBO_API_TOKEN,
      allowed_tools: ["listOrganizations"],
      require_approval: "never",
    },
  ],
});

console.log(response.output_text);

Această cerere trece de aprobare numai pentru că allowed_tools contains one read-only operation.

Approval policy

Omit require_approval sau pune-l în "always" Răspunsul va conține o cerere de aprobare MCP pe care aplicația dvs. trebuie să o prezinte unui utilizator și să o trimită înapoi într-un apel de urmărire Responses API.

Pentru o latență mai mică, puteți sări peste aprobarea unui set explicit de instrumente doar pentru citire:

{
  "allowed_tools": ["listOrganizations", "listRisks", "getRisk"],
  "require_approval": {
    "never": {
      "tool_names": ["listOrganizations", "listRisks", "getRisk"]
    }
  }
}

Do not use "require_approval": "never" without also restricting allowed_tools când token-ul poate crea sau actualiza date.

Authentication behavior

The authorization valoarea este platforma ta OAuth token. OpenAI o trimite pe serverul MCP pentru acea cerere, dar nu o stochează în obiectul de răspuns. Includeți-o în fiecare cerere de răspuns API care configurează instrumentul platforma MCP.

Accesul OAuth este limitat atât de domeniile tokenului, cât și de permisiunile platformei utilizatorului care l-a creat. Authentication pentru scară, expirare şi direcţie de rotaţie.

Troubleshooting

The MCP server returns 401

• Confirm PROBO_API_TOKEN este stabilită în procesul de aplicare.
• Confirmă că tokenul este activ și are acces la organizația solicitată.
• Include authorization in every Responses API request.

The MCP server returns 404

Confirm that server_url ends in /api/mcp/v1. The unversioned /api/mcp route and REST-style /tools/{name} Rutele nu sunt valabile pentru terminalele platformei MCP.

The model cannot call a tool

• Confirmă numele exact al instrumentului este prezent în allowed_tools.
• Confirmă că instrumentul este disponibil în the platform MCP reference.
• Încercați același punct final cu MCP Inspector.

Pentru fluxul de aprobare Responses API și schema completă de instrumente MCP, consultați OpenAI MCP documentation.