---
title: "Serwery dedykowane — API v1 i MCP | Dokumentacja Nodea"
description: "Reference modułu Serwery dedykowane: endpointy REST API v1 (lista, szczegóły), zakres infra:read, uprawnienie konta products, narzędzia MCP oraz przykłady curl i JSON-RPC."
url: "https://nodea.pl/pl/dokumentacja-api/dedicated-servers"
lang: "pl"
updated: "2026-10-14"
---

# Serwery dedykowane — API v1 i MCP | Dokumentacja Nodea

> Reference modułu Serwery dedykowane — endpointy API v1 tylko do odczytu (lista, szczegóły), zakres infra:read, widoczność w ramach konta klienta, narzędzia MCP i przykłady. Dane dostępowe Proxmox i BMC nigdy nie wracają.

Moduł **Serwery dedykowane** udostępnia odczyt serwerów dedykowanych konta klienta: status, konfigurację sprzętową, lokalizację, stan agenta nodeaD i podsumowanie rozliczenia. Każdy serwer dedykowany jest wyceniany indywidualnie (abonament + opłata instalacyjna) — zamówienie odbywa się przez zapytanie ofertowe w panelu, nie przez API. Dokument opisuje warstwę REST API v1 (/api/v1/dedicated-servers) oraz narzędzia MCP z tego modułu.

## Uwierzytelnianie i zakresy (scopes)

API v1 uwierzytelnia się tokenem osobistym Passport przez nagłówek Authorization: Bearer \<token\>. Moduł jest tylko do odczytu:

- infra:read — lista i szczegóły serwerów.

Moduł nie ma flagi Pennant. Limit zapytań: throttle:api-v1 = 240/min na użytkownika tokenu. W MCP każde narzędzie wymaga dodatkowo zakresu transportowego mcp:use.

## Konto klienta, własność i widoczność

Serwery dedykowane należą do **konta klienta** (patrz [Konta klientów](https://nodea.pl/pl/dokumentacja-api/accounts)). Żądanie działa w bieżącym koncie (przypięcie tokenu → nagłówek X-Account-Id → konto domyślne). Obok scope'a tokenu wymagane jest uprawnienie konta products. Serwer z innego konta (także innego konta tego samego użytkownika) zwraca 404 — istnienie nie jest potwierdzane.

**Bezpieczeństwo:** odpowiedzi nigdy nie zawierają danych dostępowych Proxmox VE ani BMC, notatek administracyjnych ani wewnętrznych identyfikatorów sprzętu, hosta agenta i klastra.

## API v1 — endpointy

MetodaŚcieżkaScopeOpisGET/api/v1/dedicated-serversinfra:readLista serwerów bieżącego konta (po nazwie), paginacja prosta: per\_page (1–100, domyślnie 20), page. GET/api/v1/dedicated-servers/{id}infra:readSzczegóły jednego serwera.

### Odpowiedź — DedicatedServerResource

- id, account\_id, name, hostname (nullable), primary\_ip (nullable).
- status — pending | provisioning | active | suspended | cancelled.
- specs — { cpu: string|null, ram\_gb: int|null, disks: \[{ type, size\_gb, count }\] }.
- location — { id, name, country\_code } lub null; data\_center — { id, name, code } lub null.
- agent — null, gdy do serwera nie przypisano hosta z agentem; inaczej { linked, state (provisioned|enrolled|online|offline|revoked|null), last\_seen\_at, version }.
- proxmox\_attached (bool) — czy serwer ma przypisany własny Proxmox VE.
- billing — null lub { service\_id, status, source (nodea|whmcs|external), currency, price\_cents, billing\_cycle, next\_due\_at }.
- whmcs\_managed (bool), created\_at, updated\_at (ISO8601).

### Kody błędów

- 401 — brak/niepoprawny token.
- 403 — brak scope'a infra:read, brak kontekstu konta (no\_account\_context) albo brak uprawnienia products (account\_permission\_denied).
- 404 — nieznany serwer albo serwer spoza bieżącego konta.

## Przykłady — API

### Lista serwerów

curl -s https://app.nodea.io/api/v1/dedicated-servers \\ -H "Authorization: Bearer $NODEA\_TOKEN" \\ -H "Accept: application/json"

### Szczegóły serwera

curl -s https://app.nodea.io/api/v1/dedicated-servers/42 \\ -H "Authorization: Bearer $NODEA\_TOKEN" \\ -H "Accept: application/json"

## MCP — narzędzia

Narzędzia MCP dzielą model uwierzytelniania, zakresów i konta z API v1. Serwer spoza bieżącego konta zwraca ten sam błąd co nieistniejący (brak enumeracji między najemcami).

NarzędzieScopeTrybOpisdedicated-servers-listinfra:readread-onlyLista serwerów bieżącego konta; page, per\_page (max 50). Pola jak w DedicatedServerResource, plus meta paginacji. dedicated-server-getinfra:readread-onlyJeden serwer; id (wymagany).

### Przykład — MCP (JSON-RPC)

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "dedicated-server-get", "arguments": { "id": 42 } } }

## Powiązane

- [Serwery — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/servers)
- [Konta klientów — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/accounts)
- [Rozliczenia (billing) — API v1 i MCP | Dokumentacja Nodea](https://nodea.pl/pl/dokumentacja-api/billing)

---

Wersje językowe: [en](https://nodea.io/en/api-docs/dedicated-servers.md)  
Spis treści witryny: [llms.txt](https://nodea.pl/pl/llms.txt)