Σύνδεση του Gemini στο digna¶
Αυτός ο οδηγός συνδέει τα εργαλεία Gemini της Google στον digna MCP Server. Χρειάζεστε το endpoint MCP της εγκατάστασης digna σας και ένα κλειδί API, όπως περιγράφεται στην Επισκόπηση Πρακτόρων AI.
Τα παραδείγματα χρησιμοποιούν το https://digna.example.com/mcp ως endpoint. Αντικαταστήστε το με το δικό σας.
Επιλογή Εργαλείου¶
| Εργαλείο | Για | Διαμόρφωση |
|---|---|---|
| Antigravity CLI, IDE και εφαρμογή | Τα εργαλεία πρακτόρων της Google. Το Antigravity CLI αντικατέστησε το Gemini CLI για τους ατομικούς λογαριασμούς Google τον Ιούνιο του 2026 | mcp_config.json |
| Gemini CLI | Άδειες Gemini Code Assist Standard και Enterprise, καθώς και επί πληρωμή κλειδιά Gemini API | settings.json ή gemini mcp add |
| Εφαρμογή Gemini Enterprise | — | Δεν υποστηρίζεται. Ο προσαρμοσμένος MCP connector της συνδέεται με OAuth ή με λογαριασμό υπηρεσίας Google Cloud, ενώ ο digna MCP Server αυθεντικοποιεί με κλειδιά API |
Όλα αυτά τα εργαλεία συνδέονται από το μηχάνημα στο οποίο εκτελούνται, οπότε λειτουργούν με το digna μέσα στο εταιρικό σας δίκτυο, εφόσον αυτό το μηχάνημα μπορεί να φτάσει στο endpoint.
Antigravity¶
Το Antigravity διαβάζει τους MCP servers του από το mcp_config.json, το οποίο μοιράζονται το CLI, το IDE και η εφαρμογή.
1. Άνοιγμα του mcp_config.json¶
| Εύρος | Αρχείο |
|---|---|
| Όλα τα projects σας | ~/.gemini/config/mcp_config.json |
| Ένα workspace | .agents/mcp_config.json στο workspace |
Για να ανοίξετε το αρχείο που χρησιμοποιείται:
- CLI: πληκτρολογήστε
/mcpκαι πατήστε Enter για να ανοίξει ο διαχειριστής MCP. - IDE: στο πλαϊνό πάνελ του πράκτορα, ανοίξτε το μενού …, επιλέξτε MCP Servers, μετά Manage MCP Servers και μετά View raw config.
- Εφαρμογή: μεταβείτε στο Customizations > Installed > MCP Servers και χρησιμοποιήστε το Copy Config File Path.
2. Προσθήκη του Server digna¶
Προσθέστε την καταχώριση digna. Αν το αρχείο έχει ήδη ενότητα mcpServers, προσθέστε την εκεί:
{
"mcpServers": {
"digna": {
"serverUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Το Antigravity φτάνει σε απομακρυσμένους servers μόνο μέσω streamable HTTP, το οποίο χρησιμοποιεί ο digna MCP Server. Γράψτε το endpoint ως serverUrl· το κλειδί httpUrl του Gemini CLI δεν υποστηρίζεται.
3. Επαλήθευση της Σύνδεσης¶
Στο CLI, πληκτρολογήστε /mcp: ο διαχειριστής MCP εμφανίζει τον server digna με την κατάστασή του και τα εργαλεία του, και μπορεί να επαναφορτώσει τη διαμόρφωση και να εμφανίσει τα logs σύνδεσης. Στο IDE, ο server εμφανίζεται στο Manage MCP Servers.
Προστατέψτε το Αρχείο
Το mcp_config.json περιέχει το κλειδί API σε απλό κείμενο. Κρατήστε ένα .agents/mcp_config.json του workspace εκτός ελέγχου εκδόσεων και επιτρέψτε μόνο στον δικό σας λογαριασμό να διαβάζει το καθολικό αρχείο.
Gemini CLI¶
1. Προσθήκη του Server¶
Βάλτε το κλειδί API σε μια μεταβλητή περιβάλλοντος και μετά προσθέστε τον server:
export DIGNA_API_KEY='<api key>'
gemini mcp add --transport http --scope user --header "Authorization: Bearer $DIGNA_API_KEY" digna https://digna.example.com/mcp
Το shell σας συμπληρώνει το $DIGNA_API_KEY όταν εκτελείτε την εντολή, οπότε το Gemini CLI αποθηκεύει το κλειδί στις ρυθμίσεις του. Χωρίς --scope user, ο server προστίθεται μόνο στο τρέχον project.
2. Ή Επεξεργασία του settings.json¶
Η παραπάνω εντολή γράφει στο settings.json. Για να επεξεργαστείτε το αρχείο μόνοι σας:
| Εύρος | Αρχείο |
|---|---|
| Όλα τα projects σας | ~/.gemini/settings.json |
| Ένα project | .gemini/settings.json στο project |
{
"mcpServers": {
"digna": {
"httpUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Χρησιμοποιήστε το httpUrl, το κλειδί για streamable HTTP. Το παρόμοιο κλειδί url επιλέγει την παλαιότερη μεταφορά SSE, την οποία ο digna MCP Server δεν προσφέρει. Μη χρησιμοποιείτε κάτω παύλες στο όνομα του server.
Αφήστε το Trust Απενεργοποιημένο
Το Gemini CLI ζητά επιβεβαίωση πριν από κάθε κλήση εργαλείου, εκτός αν ο server έχει "trust": true. Αφήστε το trust απενεργοποιημένο για το digna, ώστε να επιβεβαιώνετε κάθε αλλαγή που κάνει ένας πράκτορας στη διαμόρφωσή σας.
3. Επαλήθευση της Σύνδεσης¶
Από το shell σας:
Ο server digna πρέπει να εμφανίζεται ως συνδεδεμένος. Μέσα σε μια συνεδρία Gemini CLI, εκτελέστε /mcp για να δείτε τον server και τα εργαλεία του.
Αντιμετώπιση Προβλημάτων στο Gemini¶
Ο Server Εμφανίζεται ως Αποσυνδεδεμένος¶
- Ελέγξτε ότι το endpoint τελειώνει σε
/mcpκαι είναι προσβάσιμο από το μηχάνημά σας. - Ελέγξτε το όνομα του κλειδιού:
serverUrlστο Antigravity,httpUrlστο Gemini CLI. - Ένα
401σημαίνει ότι το κλειδί απορρίφθηκε· δείτε 401 Unauthorized.
Το Gemini CLI Δεν Ξεκινά Πλέον για τον Λογαριασμό μου¶
Από τον Ιούνιο του 2026, οι ατομικοί λογαριασμοί Google χρησιμοποιούν το Antigravity CLI αντί για το Gemini CLI. Μεταφέρετε την καταχώριση digna στο mcp_config.json όπως περιγράφεται στην ενότητα Antigravity και μετονομάστε το httpUrl σε serverUrl.
Δείτε Επίσης¶
- Επισκόπηση Πρακτόρων AI: endpoint, κλειδί API, ασφάλεια και γενική αντιμετώπιση προβλημάτων
- Claude: σύνδεση του Claude Code, του Claude Desktop ή ενός προσαρμοσμένου connector
- digna Agentic: τι μπορούν να κάνουν οι πράκτορες AI με το digna