scalingo
Manage Scalingo PaaS apps, deployments, containers, logs and env vars from your AI assistant.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"scalingo": {
"url": "https://scalingo.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://scalingo.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(21)
🟢list_apps
List all Scalingo apps you can access in the current region. Scalingo API: GET /v1/apps. Returns { apps: [...] }.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app(app)
Fetch a single app's details (region, stack, status, URLs, flags). Scalingo API: GET /v1/apps/{app}. Returns { app }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_containers(app)
List an app's container formation — the running process types with their amount and size (the current scaling). Scalingo API: GET /v1/apps/{app}/containers. Returns { containers: [{ name, amount, size }] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app_stats(app)
Real-time per-container resource stats (CPU / memory / swap usage) for an app. Scalingo API: GET /v1/apps/{app}/stats. Returns { stats: [...] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_deployments(app, page, per_page)
List an app's deployments (most recent first), paginated. Scalingo API: GET /v1/apps/{app}/deployments. Returns { deployments: [...], meta: { pagination } }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"page": {
"description": "Page number (1-based) for paginated lists.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Entries per page (1-100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_deployment(app, deployment_id)
Fetch a single deployment's details (status, git_ref, pusher, image size, timestamps). Scalingo API: GET /v1/apps/{app}/deployments/{deployment_id}. Returns { deployment }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"deployment_id": {
"type": "string",
"description": "The deployment id."
}
},
"required": [
"app",
"deployment_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_app_logs(app, lines)
Fetch recent application log lines. Scalingo returns an authenticated logs_url (GET /v1/apps/{app}/logs → { logs_url }); this tool then downloads the last N lines from it (dump mode) and returns them as text. Returns { logs_url, lines }. If the follow-up download fails, only logs_url is returned so you can fetch it yourself.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"lines": {
"description": "Number of recent log lines to fetch (1-1000, default 100).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_variables(app)
List an app's environment variables. WARNING: this exposes secret VALUES (API keys, database URLs, etc.). Scalingo API: GET /v1/apps/{app}/variables. Returns { variables: [{ id, name, value }] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_collaborators(app)
List an app's collaborators (users invited to the app) and their status. Scalingo API: GET /v1/apps/{app}/collaborators. Returns { collaborators: [...] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_domains(app)
List an app's custom domains and their TLS/canonical status. Scalingo API: GET /v1/apps/{app}/domains. Returns { domains: [...] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_addons(app)
List the addons (databases, services) provisioned on an app. Scalingo API: GET /v1/apps/{app}/addons. Returns { addons: [...] }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_addon_providers(category_id)
List the addon providers available on Scalingo (databases, monitoring, etc.) with their plans embedded. Scalingo API: GET /v1/addon_providers. Returns { addon_providers: [{ ..., plans: [...] }] }.
入力スキーマ
{
"type": "object",
"properties": {
"category_id": {
"description": "Optional category id to filter providers.",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_app_events(app, page, per_page, from)
List an app's activity events (deployments, scaling, restarts, collaborator changes, etc.), paginated. Scalingo API: GET /v1/apps/{app}/events. Returns { events: [...], meta: { pagination } }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"page": {
"description": "Page number (1-based) for paginated lists.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Entries per page (1-100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"from": {
"description": "Restrict to events from the last N hours (1-72).",
"type": "integer",
"minimum": 1,
"maximum": 72
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_operation(app, operation_id)
Poll the status of an asynchronous operation (e.g. a scale or restart returns an operation to track). Scalingo API: GET /v1/apps/{app}/operations/{operation_id}. Returns { operation } with status pending|running|done|error.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"operation_id": {
"type": "string",
"description": "The operation id (returned in the Location header of a scale/restart response)."
}
},
"required": [
"app",
"operation_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_regions
List the Scalingo regions available to your account, each with its API/dashboard/database hosts. Useful to discover the right SCALINGO_REGION. Scalingo API: GET (auth host) /v1/regions. Returns { regions: [...] }.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_account
Fetch the authenticated user's account (id, email, username, fullname, company). Scalingo API: GET /v1/users/self. Returns { user }.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢scalingo_request(path, query, on_auth_host)
Power-user escape hatch: GET any Scalingo API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /v1 (e.g. "/apps/my-app/alerts"). By default hits the regional API; set on_auth_host:true for auth-host resources (regions, scm_integrations, tokens). Scalingo API: GET {path}.
入力スキーマ
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "API path after /v1, starting with a slash, e.g. \"/apps/my-app/notifiers\"."
},
"query": {
"description": "Optional query params object.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"on_auth_host": {
"description": "If true, target the auth host (auth.scalingo.com) instead of the regional API.",
"type": "boolean"
}
},
"required": [
"path"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴restart_app(app, scope)
MUTATES Scalingo infrastructure — restarts an app's containers. Optionally restart only specific process types via scope; omit scope to restart everything. Returns 202 Accepted (track via get_operation). Scalingo API: POST /v1/apps/{app}/restart.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"scope": {
"description": "Container types to restart, e.g. [\"web\",\"worker\"]. Omit to restart all.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"app"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴scale_app(app, containers)
MUTATES Scalingo infrastructure — sets the container formation (number and/or size of each process type). Only the container types you include are changed. Returns 202 Accepted (track via get_operation). Scalingo API: POST /v1/apps/{app}/scale.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"containers": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Process type name, e.g. \"web\" or \"worker\"."
},
"amount": {
"description": "Number of containers of this type.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Container size, e.g. \"S\", \"M\", \"L\", \"2XL\".",
"type": "string"
}
},
"required": [
"name"
]
},
"description": "Formation entries to apply. Each entry needs a name plus amount and/or size."
}
},
"required": [
"app",
"containers"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴set_variables(app, variables)
MUTATES Scalingo infrastructure — creates or updates environment variables in bulk (each { name, value } is created if new or updated if it exists). This usually triggers a restart to apply the new env. Names ≤64 chars, values ≤8192 chars. Scalingo API: PUT /v1/apps/{app}/variables. Returns { variables }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"variables": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Variable name (uppercase convention, ≤64 chars)."
},
"value": {
"type": "string",
"description": "Variable value (≤8192 chars)."
}
},
"required": [
"name",
"value"
]
},
"description": "Environment variables to create/update."
}
},
"required": [
"app",
"variables"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴trigger_deployment(app, source_url, git_ref)
MUTATES Scalingo infrastructure — triggers a new deployment from a source archive URL (a tar.gz reachable by Scalingo). To roll back, re-deploy a previous git_ref/archive — there is no separate rollback endpoint. Scalingo API: POST /v1/apps/{app}/deployments. Returns { deployment }.
入力スキーマ
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "The app name (e.g. my-production-app) or app id (app-…)."
},
"source_url": {
"type": "string",
"description": "URL of the source archive (tar.gz) Scalingo should build and deploy."
},
"git_ref": {
"description": "Optional git reference label for the deployment (branch/tag/SHA).",
"type": "string"
}
},
"required": [
"app",
"source_url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}推奨プロンプト
get_appget_applist_appslist_appslist_appsget_appコミュニティ
エビデンス