For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/pl/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/pl/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/pl/guides/web-cloud/domains/mcp-domain-getting-started.md.

Pierwsze kroki z serwerem MCP dla nazw domen

Pokaż jako Markdown

Podłącz agenta AI do serwera MCP OVHcloud, aby zarządzać nazwami domen, rekordami DNS i przekierowaniami w języku naturalnym

Info

Serwer MCP OVHcloud jest aktywnie rozwijany. Lista dostępnych narzędzi jest regularnie rozszerzana: funkcja, której dziś brakuje, może być dostępna już wkrótce. Aktualny wykaz znajdziesz w hubie MCP OVHcloud.

Wprowadzenie

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentowi AI korzystać z zewnętrznych narzędzi. Serwer MCP OVHcloud udostępnia Twoje usługi OVHcloud w postaci takich narzędzi, dzięki czemu asystent może odczytywać i zmieniać konfigurację w Twoim imieniu.

W praktyce oznacza to, że nie musisz już klikać w interfejsach ani pisać wywołań API — wystarczy, że poprosisz:

Wypisz moje domeny i powiedz mi, które wygasają w ciągu najbliższych 60 dni.

Niniejszy przewodnik wyjaśnia, jak podłączyć agenta AI do serwera MCP OVHcloud i używać go do zarządzania nazwami domen, rekordami DNS i przekierowaniami.

Wymagania początkowe

  • Dostęp do
  • Zainstalowany zgodny klient MCP (patrz Podłączenie agenta)
  • Przeglądarka, aby przeprowadzić uwierzytelnianie OAuth2

W praktyce

1 — Jak działa MCP

W procesie biorą udział trzy elementy:

ElementRola
Twój agent AIAsystent, z którym rozmawiasz (agent w terminalu, czat w IDE, Twoja własna aplikacja)
Serwer MCP OVHcloudPublikuje dostępne narzędzia i wykonuje je na Twoim koncie
Twoje konto OVHcloudUprawnienia weryfikowane przy każdym wywołaniu, które decydują o tym, co agent może zrobić

Nigdy nie wywołujesz narzędzia po nazwie. Opisujesz, czego oczekujesz, agent wybiera odpowiednie narzędzie i prosi Cię o potwierdzenie, zanim cokolwiek zmieni.

Warning

Agent AI podłączony do MCP działa z Twoimi uprawnieniami. Przeczytaj każdą prośbę o potwierdzenie, zanim ją zaakceptujesz, zwłaszcza w przypadku operacji usuwających rekordy lub zmieniających serwery DNS.

2 — Hub MCP OVHcloud

Hub MCP OVHcloud zawiera wykaz usług udostępnionych w postaci narzędzi MCP. To źródło informacji o tym, co jest dostępne.

Wybierz adres URL odpowiadający regionowi Twojego konta OVHcloud:

RegionAdres URL serwera MCP
Europahttps://mcp.eu.ovhcloud.com/mcp/{section}
Kanadahttps://mcp.ca.ovhcloud.com/mcp/{section}

Zastąp {section} nazwą sekcji, z którą chcesz się połączyć, w postaci widocznej na kartach huba. Zawsze łączysz się z konkretną sekcją: nie istnieje jeden globalny adres URL udostępniający wszystkie narzędzia naraz.

Sekcje dotyczące nazw domen

Nazwy domen obsługiwane są przez dwie sekcje, po jednej na każdą wersję API:

SekcjaUdostępniana zawartość
v1_domainNarzędzia domenowe API v1
v2_domainNarzędzia domenowe API v2

Dla konta europejskiego korzystającego z API v1 adres URL to zatem https://mcp.eu.ovhcloud.com/mcp/v1_domain.

Obecnie API v1 pozostaje najbogatsze funkcjonalnie: sekcja v1_domain udostępnia więc szerszy zestaw narzędzi niż v2_domain. API v2 jest stopniowo rozwijane.

Aby zrozumieć, czym API v2 różni się od API v1, zapoznaj się z przewodnikiem OVHcloud API v2 - Principles of operation.

Możesz dodać jedną, drugą albo obie jednocześnie. Sama sekcja v1_domain wystarczy do wykonania wszystkich operacji opisanych w tym przewodniku.

3 — Podłączenie agenta do MCP

Uwierzytelnianie odbywa się przez OAuth2: przy pierwszym kontakcie agenta z serwerem otworzy się okno przeglądarki ze stroną logowania OVHcloud. Po zalogowaniu agent wykorzystuje tę sesję do swoich wywołań MCP.

Info

Nie jest wymagany żaden własny nagłówek HTTP: dane uwierzytelniające dostarcza mechanizm OAuth2. Instrukcje konfiguracji OVHcloud zalecają, aby sekcję nagłówków w konfiguracji Twojego klienta MCP pozostawić pustą.

SHAI
Goose
Claude Code

SHAI to agent terminalowy OVHcloud. Wymagana jest wersja 0.1.5 lub nowsza.

Utwórz następujący plik konfiguracyjny na podstawie szablonu .ovh.config z repozytorium SHAI:

$HOME/.config/shai/agents/ovh.config

Zadeklaruj w tools.mcp po jednym wpisie na każdą sekcję, z której chcesz korzystać. Poniższy przykład włącza obie wersje API:

{
  "name": "ovh",
  "description": "OVH agent with OVH MCP server for cloud management and API calls",
  "tools": {
    "builtin": ["*"],
    "builtin_excluded": [],
    "mcp": {
      "v1_domain": {
        "config": {
          "type": "http",
          "url": "https://mcp.eu.ovhcloud.com/mcp/v1_domain"
        },
        "enabled_tools": ["*"]
      },
      "v2_domain": {
        "config": {
          "type": "http",
          "url": "https://mcp.eu.ovhcloud.com/mcp/v2_domain"
        },
        "enabled_tools": ["*"]
      }
    }
  },
  "system_prompt": "{{CODER_BASE_PROMPT}}",
  "max_tokens": 4096,
  "temperature": 0.3
}

Zastąp punkty końcowe adresami właściwymi dla Twojego regionu.

Info

Nie wpisuj ręcznie żadnych danych uwierzytelniających do tego pliku. Po zalogowaniu SHAI sam zapisuje access_token oraz expires_at w bloku config każdego serwera. Wartości te są osobistymi danymi poufnymi: nigdy nie umieszczaj tego pliku w repozytorium ani nie udostępniaj go w niezmienionej postaci.

Następnie uruchom agenta. Otworzy się okno przeglądarki ze stroną logowania OVHcloud; zaloguj się, aby zakończyć nawiązywanie połączenia.

Aby sprawdzić, czy połączenie działa, zadaj agentowi pytanie, które wymaga jedynie odczytu danych:

Wypisz moje domeny w OVHcloud.

4 — Wyświetlenie informacji o nazwie domeny

Zacznij od wypisania swoich domen, a następnie poproś o szczegóły jednej z nich.

Przykładowe polecenie:

Pokaż mi szczegóły mydomain.ovh: datę wygaśnięcia, serwery DNS i stan blokady transferu.

5 — Zamówienie nazwy domeny

Zamówienie nazwy domeny realizuje narzędzie order-new-domain-name, dostępne w sekcji v1_domain.

Przykładowe polecenie:

Zamów mydomain.ovh na rok.

Zanim cokolwiek kupisz, poproś o symulację. Narzędzie przyjmuje parametr dryRun: ustawienie go na true powoduje sprawdzenie dostępności nazwy i wyliczenie ceny, bez składania zamówienia i bez naliczania jakichkolwiek opłat.

Zasymuluj zamówienie mydomain.ovh na rok.

Agent wyświetli wówczas wycenę — cenę, okres i konfigurację, która zostanie zastosowana do domeny — i poczeka na Twoją zgodę, zanim przejdzie dalej.

Po zatwierdzeniu wyceny agent ponawia wywołanie z parametrem dryRun ustawionym na false. Zamówienie staje się wiążące: API zwraca adres URL zamówienia. Agent przekazuje Ci ten adres bezpośrednio w swojej odpowiedzi: otwórz go w przeglądarce, aby opłacić zamówienie. To zamówienie znajdziesz również w Panelu klienta OVHcloud, na stronie .

Info

Zamówienie musi zostać opłacone, aby rejestracja została przekazana do rejestru. Agent nie może zapłacić za Ciebie: otwórz zwrócony przez niego adres URL zamówienia, aby dokonać płatności. Dopóki płatność nie zostanie zaksięgowana, nazwa domeny pozostaje dostępna dla osób trzecich.

Warning

Zatwierdzenie zamówienia tworzy na Twoim koncie OVHcloud rzeczywiste, płatne zamówienie. Przeczytaj prośbę o potwierdzenie wysłaną przez agenta, zanim ją zaakceptujesz, i sprawdź nazwę domeny oraz okres: rejestracji nie da się cofnąć tak jak zmiany konfiguracji.

6 — Modyfikacja rekordu DNS

Powiązane narzędzia: create-domain-zone-record do dodania rekordu, delete-domain-zone-record do usunięcia rekordu oraz get-domain-zone-details do sprawdzenia strefy.

Przykładowe polecenia:

Zmień rekord A dla www.mydomain.ovh na 203.0.113.42.

Nie musisz wiedzieć, jaki typ rekordu należy zmienić. Opisz oczekiwany rezultat: agent ustali, o który rekord chodzi, wyjaśni, co zamierza zmienić, i poczeka na Twoją zgodę przed wprowadzeniem zmiany.

Moja strona WWW jest teraz hostowana na serwerze o adresie IP 203.0.113.42.
Skieruj www.mydomain.ovh na ten adres.
Warning

Zmodyfikowany rekord DNS staje się aktywny dopiero po odświeżeniu strefy. Jeśli pominiesz ten etap, zmiana zostanie zapisana, ale nigdy nie zostanie zastosowana. Wyraźnie poproś agenta o odświeżenie strefy albo sprawdź, czy to zrobił.

Propagacja w internecie może następnie potrwać do 24 godzin, w zależności od wartości TTL rekordu.

7 — Utworzenie przekierowania

Przekierowanie kieruje odwiedzających Twoją domenę pod inny adres.

Przykładowe polecenie:

Przekieruj blog.mydomain.ovh na https://mydomain.ovh/aktualnosci, tak aby adres pozostał widoczny w przeglądarce.

8 — Pozostałe obsługiwane operacje

Sekcje v1_domain i v2_domain udostępniają odpowiadające im ścieżki API OVHcloud w postaci narzędzi: każdą operację, którą można wykonać na nazwach domen przez API, można wykonać również przez MCP. Poza opisanymi wyżej zadaniami obejmuje to na przykład:

  • DNSSEC: włączanie, wyłączanie i zarządzanie rekordami DS
  • Blokada transferu: włączanie i wyłączanie
  • Zarządzanie kontaktami: właściciel, kontakt administracyjny, techniczny i księgowy
  • Serwery DNS i rekordy GLUE
  • Identyfikatory i rekordy DynHost (dynamiczny DNS)
  • Kopia zapasowa, przywracanie, import i eksport strefy
  • Zarządzanie zadaniami: przyspieszanie, anulowanie, ponawianie
  • Pobieranie kodu AuthInfo i zatwierdzanie transferów wychodzących

Jeśli nie masz pewności, czy dana operacja jest możliwa, poproś agenta, aby wyjaśnił, co potrafi zrobić z Twoimi nazwami domen.

Sprawdź również

Order a Domain Name

Configure the DNS of your Domain Name

Przekierowanie nazwy domeny zarządzanej w OVHcloud

AI Endpoints - Model Context Protocol (MCP) with LangChain4j

Informacje dotyczące administrowania usługami OVHcloud oraz jak znaleźć odpowiednią pomoc

Podczas korzystania z przewodników OVHcloud pamiętaj o następujących warunkach:

  • Instrukcje zawierają możliwie najwięcej szczegółów, ale nie mogą obejmować wszystkich indywidualnych przypadków użycia. Może być konieczne dostosowanie opisanych działań do Twoich potrzeb.
  • Ekosystem OVHcloud został zaprojektowany z myślą o elastyczności i swobodzie wyboru. Klienci są zatem odpowiedzialni za bezpieczną i prawidłową konfigurację swoich usług. Aby zapobiec utracie danych, zdecydowanie zalecamy stosowanie strategii kopii zapasowych dla wszystkich ważnych danych.
  • Nasze przewodniki i tutoriale mogą odwoływać się do oprogramowania lub usług firm trzecich w połączeniu z rozwiązaniami OVHcloud. Wsparcie techniczne OVHcloud nie obejmuje konfiguracji systemów ani produktów pozostających poza naszą odpowiedzialnością. Dotyczy to między innymi:
    • Systemów operacyjnych i interfejsów użytkownika (Windows, Debian, Plesk itp.).
    • Wszelkiego innego oprogramowania firm trzecich (klienty FTP, programy pocztowe itp.).
    • Usług oferowanych przez innych dostawców (DNS, API, interfejsy użytkownika itp.).

Aby uzyskać odpowiednią pomoc w przypadku problemów, postępuj zgodnie z poniższymi wskazówkami:

  • Szukasz spersonalizowanej porady lub chcesz omówić temat, który nie został szczegółowo opisany w naszej dokumentacji?
    Dołącz do społeczności OVHcloud, aby wyszukać swój temat i skontaktować się z innymi użytkownikami.
  • Musisz zgłosić incydent dotyczący Twojej usługi OVHcloud lub masz trudności w panelu klienta OVHcloud?
    Utwórz zgłoszenie do wsparcia w naszym centrum pomocy.
  • Potrzebujesz profesjonalnej pomocy przy swoim projekcie lub wsparcia w zadaniach wykraczających poza zakres naszego wsparcia?
    Odwiedź nasz portal partnerów, aby znaleźć ekspertów znających rozwiązania OVHcloud.
  • Szukasz bardziej szczegółowych informacji o naszych poziomach wsparcia i usługach Professional Services?
    Odwiedź nasze strony internetowe: poziomy wsparcia OVHcloud oraz OVHcloud Professional Services.

Możesz uczestniczyć w ulepszaniu naszej dokumentacji:

  • Chcesz przekazać opinię, aby ulepszyć stronę przewodnika, lub zgłosić niewystarczające informacje na konkretnej stronie?
    Skorzystaj z przycisków „Czy ta strona była pomocna?” na dole strony, aby nas o tym poinformować.
  • Chcesz zaproponować konkretną aktualizację dokumentacji?
    Skorzystaj z funkcji „Edytuj tę stronę”, dostępnej na dole strony oraz w panelu bocznym.

Dołącz do grona naszych użytkowników.

Czy ta strona była pomocna?