Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

MCP και Συνδετήρες: Σύνδεση Εξωτερικών Υπηρεσιών

Μάθημα 9 / 25 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. MCP και Συνδετήρες: Σύνδεση Εξωτερικών Υπηρεσιών
  2. Τι είναι το MCP;
  3. Σύνδεση ενός Διακομιστή MCP
  4. Απομακρυσμένοι Διακομιστές MCP μέσω SSE
  5. Συνδετήρες της OpenAI
  6. Συνδυασμός MCP και Εργαλείων Συναρτήσεων
  7. Φιλτράρισμα Εργαλείων MCP
  8. Διαχείριση Σφαλμάτων MCP
  9. Βασικά σημεία

Ενημερώθηκε στις 2 Νοεμβρίου 2026 — Agent Builder. Στις 3 Ιουνίου 2026, η OpenAI ανακοίνωσε την παύση λειτουργίας του Agent Builder, η οποία προγραμματίζεται για τις 30 Νοεμβρίου 2026· το ChatKit παραμένει διαθέσιμο. Στο εξής, η OpenAI κατευθύνει τους χρήστες προς το Agents SDK ή τους πράκτορες του χώρου εργασίας (workspace) του ChatGPT. Από τις 10 Σεπτεμβρίου 2026, η OpenAI προσφέρει μια δημόσια beta έκδοση του Agents API που φιλοξενεί την ενορχήστρωση πρακτόρων (βλ. ChatGPT το 2026, Μάθημα 10).

MCP και Συνδετήρες: Σύνδεση Εξωτερικών Υπηρεσιών

Το Πρωτόκολλο Πλαισίου Μοντέλου (Model Context Protocol - MCP) είναι ένα ανοιχτό πρότυπο που επιτρέπει στον πράκτορά σας να συνδέεται με εξωτερικές υπηρεσίες με τυποποιημένο τρόπο. Αντί να ξαναγράφετε ενσωματώσεις για κάθε υπηρεσία, συνδέετε έναν διακομιστή MCP και ο πράκτοράς σας αποκτά άμεσα νέα εργαλεία. Εκεί που ίσως γράφατε τριακόσιες γραμμές κώδικα πελάτη GitHub, τώρα χρειάζεστε μόνο μια δήλωση διακομιστή.

Τι είναι το MCP;

Το MCP είναι ένα ανοιχτό πρότυπο που ορίζει πώς ένας πελάτης—ο πράκτοράς σας—επικοινωνεί με έναν διακομιστή, δηλαδή μια εξωτερική υπηρεσία. Κάθε διακομιστής MCP εκθέτει εργαλεία που μπορεί να χρησιμοποιήσει ο πράκτοράς σας. Το πρωτόκολλο διαχειρίζεται τη μεταφορά, τη σειριοποίηση και την ανακάλυψη εργαλείων. Αυτό το τελευταίο χαρακτηριστικό είναι το πιο πολύτιμο για την καθημερινή εργασία: ο πράκτορας ερωτά τον διακομιστή για να δει τι μπορεί να κάνει, ώστε εσείς να μην χρειάζεται να συντηρείτε μια λίστα. Το Agents SDK περιλαμβάνει εγγενή υποστήριξη για MCP και συνδέεται με οποιονδήποτε συμβατό διακομιστή.

Σύνδεση ενός Διακομιστή MCP

Το SDK παρέχει την κλάση MCPServerStdio για τοπικούς διακομιστές που επικοινωνούν μέσω stdin/stdout—τυπικά μια διαδικασία Node που εκκινείται με npx.

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

# Τοπικός διακομιστής MCP (επικοινωνεί μέσω stdin/stdout)
file_server = MCPServerStdio(
    name="File Manager",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"],
)

async def main():
    async with file_server:
        agent = Agent(
            name="File Agent",
            instructions="You manage files for the user.",
            mcp_servers=[file_server],
        )
        result = await Runner.run(agent, "List the files in the root folder.")
        print(result.final_output)

Το μπλοκ async with δεν είναι απλώς διακόσμηση: εκκινεί τη διαδικασία του διακομιστή, ανακαλύπτει τα εργαλεία του και τον τερματίζει καθαρά όταν το μπλοκ ολοκληρωθεί. Ένας πράκτορας που δημιουργείται εκτός αυτού του πλαισίου δεν θα έχει κανένα εργαλείο.

Απομακρυσμένοι Διακομιστές MCP μέσω SSE

Για διακομιστές που φιλοξενούνται (hosted), χρησιμοποιήστε το MCPServerSse και τη μεταφορά SSE (Server-Sent Events). Η λογική παραμένει η ίδια· αλλάζουν μόνο το URL και οι κεφαλίδες αυθεντικοποίησης.

from agents.mcp import MCPServerSse

github_server = MCPServerSse(
    name="GitHub",
    url="https://mcp.github.com/sse",
    headers={"Authorization": "Bearer ghp_your_token"},
)

async def main():
    async with github_server:
        agent = Agent(
            name="DevOps Agent",
            instructions="You manage GitHub repositories.",
            mcp_servers=[github_server],
        )
        result = await Runner.run(
            agent,
            "Create an issue in the my-project repo with the title 'Critical Bug'"
        )
        print(result.final_output)

Συνδετήρες της OpenAI

Εκτός από το MCP, η OpenAI προσφέρει συνδετήρες που διαχειρίζονται απευθείας στην πλατφόρμα. Αυτοί ενσωματώνονται στο Agent Builder και παραμένουν usable μέσω του SDK χωρίς να απαιτείται να φιλοξενήσετε εσείς έναν διακομιστή.

from agents import Agent, Runner

# Οι συνδετήρες που ρυθμίζονται στο Agent Builder είναι αυτόματα διαθέσιμοι
agent = Agent(
    name="CRM Agent",
    instructions="""You are a CRM assistant. Use the connectors
    to access Salesforce, HubSpot, and Google Workspace.""",
    model="gpt-5.6-terra",
    # Οι συνδετήρες συνδέονται με τη διαμόρφωση του πράκτορα στην πλατφόρμα
)

Η απουσία της παραμέτρου mcp_servers έχει νόημα: οι συνδετήρες είναι δεσμευμένοι στη διαμόρφωση του πράκτορα στην πλατφόρμα. Διαχειρίζονται για εσάς την αυθεντικοποίηση OAuth, τη σελιδοποίηση και τον περιορισμό ρυθμού—τρεις τομείς που καταναλώνουν σημαντικό χρόνο όταν γίνονται χειροκίνητα.

Συνδυασμός MCP και Εργαλείων Συναρτήσεων

Δεν χρειάζεται να επιλέξετε. Ένας μοναδικός πράκτορας μπορεί να χρησιμοποιήσει έναν διακομιστή MCP για πρόσβαση σε δεδομένα και τις δικές σας συναρτήσεις για επιχειρηματική λογική που δεν θέλετε να αναθέσετε elsewhere.

from agents import Agent, Runner, function_tool
from agents.mcp import MCPServerStdio

@function_tool
def calculate_invoice(amount_excl_tax: float, vat_rate: float = 20.0) -> str:
    """Calculates the total amount including tax for an invoice."""
    amount_incl_tax = amount_excl_tax * (1 + vat_rate / 100)
    return f"Excl. tax: €{amount_excl_tax}, VAT {vat_rate}%: €{amount_excl_tax * vat_rate / 100:.2f}, Incl. tax: €{amount_incl_tax:.2f}"

db_server = MCPServerStdio(
    name="Database",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/mydb"],
)

async def main():
    async with db_server:
        agent = Agent(
            name="Accounting Agent",
            instructions="""You handle accounting.
            Use the database for customer data
            and the calculation function for invoices.""",
            tools=[calculate_invoice],
            mcp_servers=[db_server],
        )
        result = await Runner.run(
            agent,
            "Retrieve orders for customer Alice and calculate the total invoice"
        )
        print(result.final_output)

Ο υπολογισμός του ΦΠΑ παραμένει στον κώδικά σας, όπου είναι ελέγχιμος και ελεγχόμενος· η ανάκτηση παραγγελιών γίνεται μέσω του διακομιστή PostgreSQL MCP. Αυτός είναι ο διαχωρισμός στον οποίο πρέπει να στοχεύετε.

Φιλτράρισμα Εργαλείων MCP

Ένας διακομιστής MCP μπορεί να εκθέτει δεκάδες εργαλεία, τα περισσότερα από τα οποία δεν θα έχουν σημασία για τη δική σας περίπτωση χρήσης—και καθένα από αυτά καταναλώνει πλαίσιο (context) και αυξάνει τον κίνδυνο μιας ακατάλληλης κλήσης. Ξεκινήστε επιθεωρώντας τι είναι πραγματικά διαθέσιμο.

server = MCPServerStdio(
    name="GitHub",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-github"],
)

# Μπορείτε να κάνετε φιλτράρισμα κατά τη σύνδεση
async with server:
    tools = await server.list_tools()
    # Επιθεώρηση διαθέσιμων εργαλείων
    for tool in tools:
        print(f"- {tool.name}: {tool.description}")

Διαχείριση Σφαλμάτων MCP

Ένας διακομιστής MCP είναι μια διαδικασία ή μια απομακρυσμένη υπηρεσία: μπορεί να αποτύχει να εκκινήσει, να χάσει τη σύνδεσή του ή να έχει λήξει το διακριτικό (token) του. Σχεδιάστε για μια υποβαθμισμένη λειτουργία αντί να αφήσετε την εξαίρεση να αναδυθεί μέχρι τον χρήστη.

from agents.mcp import MCPServerStdio

async def create_agent_with_mcp():
    server = MCPServerStdio(
        name="External Service",
        command="npx",
        args=["-y", "my-mcp-server"],
    )

    try:
        async with server:
            agent = Agent(
                name="My Agent",
                instructions="Use the external service.",
                mcp_servers=[server],
            )
            result = await Runner.run(agent, "Execute the task.")
            return result.final_output
    except Exception as e:
        # Εναλλακτική λύση χωρίς MCP
        fallback_agent = Agent(
            name="My Agent (degraded mode)",
            instructions="The external service is unavailable. Inform the user.",
        )
        result = await Runner.run(fallback_agent, "The service is unavailable.")
        return result.final_output

Ο πράκτορας εναλλακτικής λύσης δεν προσποιείται ότι λειτουργεί: ανακοινώνει τη μη διαθεσιμότητα. Ένας πράκτορας που επινοεί μια απάντηση όταν η πηγή δεδομένων του είναι εκτός λειτουργίας κοστίζει πολύ περισσότερο από έναν που παραδέχεται ότι δεν μπορεί να προχωρήσει.

Βασικά σημεία

  • Το MCP είναι ένα ανοιχτό πρωτόκολλο για τη σύνδεση εξωτερικών υπηρεσιών με τον πράκτορά σας
  • Χρησιμοποιήστε το MCPServerStdio για τοπικούς διακομιστές και το MCPServerSse για απομακρυσμένους διακομιστές
  • Οι Συνδετήρες της OpenAI είναι ενσωματώσεις που διαχειρίζονται στην πλατφόρμα
  • Μπορείτε να συνδυάσετε εργαλεία συναρτήσεων και διακομιστές MCP στον ίδιο πράκτορα
  • Διαχειριστείτε τα σφάλματα σύνδεσης MCP με μια υποβαθμισμένη λειτουργία