• DIAGNOSIS
  • RECOVERY
  • ANALYSIS
  • HUMAN

How to troubleshoot and restart services with your AI

Connect Northflank to your AI client to manage your cloud workloads. Once connected, your agent can diagnose resource bottlenecks and fix them directly.

Ask AI about this page

Short answer

How do I troubleshoot and restart services with my AI?

Your AI uses Northflank tools to pull resource usage data and restart specific services. You can identify if a container is hitting CPU or memory limits and then tell your agent to cycle the replicas to clear the issue.

Troubleshooting outcomes.

Where every issue lands.

What happens when you ask your AI to fix a service.

DIAGNOSIS

Identify resource leaks

The AI checks service limits and usage. You get a clear picture of why a container is failing.

RECOVERY

Cycle container replicas

Your agent triggers a restart to clear memory pressure. This gets your service back online quickly.

ANALYSIS

Compare limits to usage

The AI looks at the gap between allocated resources and actual demand. You'll know if you need to scale up.

HUMAN

Manual configuration

The AI cannot rewrite your deployment YAML or change environment variables. You'll handle those structural changes yourself.

The workflow

What your AI does when a service fails.

The AI handles the heavy lifting of checking logs and status, then executes the fix.

  1. Fetch service data

    The AI pulls the current configuration and resource constraints for your running services.

    get_service

  2. Detect bottlenecks

    By looking at the service data, the AI identifies if CPU or memory limits are being hit.

    get_service

  3. Execute a restart

    Once you confirm the issue, the AI triggers a restart to refresh the container instances.

    restart_service

  4. Verify recovery

    The AI checks the service status again to ensure the replicas are healthy and running.

    get_service

Try it

Copy these to start.

Use these prompts to kick off a troubleshooting session.

Starting points

Replace the service names with your actual Northflank service identifiers.

Northflank Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_geMoJ5G8AXHTcf6ry4BH4pzpuf69uz3m4ZSGhSdn/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Northflank capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "northflank-developer-cloud-orchestration-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_geMoJ5G8AXHTcf6ry4BH4pzpuf69uz3m4ZSGhSdn/mcp"
    }
  }
}
Copy into chat04

  • Check the resource limits for my 'api-gateway' service.

  • Why is my 'worker-node' service hitting its memory limit?

  • Restart the 'auth-service' replicas to clear the CPU spike.

  • Get the current status of all services in my Northflank project.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Northflank once, then ask.

Just link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start managing services from your favorite AI client.

Connect Northflank to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my service's CPU limits?

    No. The AI can only read current limits and restart services. You must adjust resource allocations manually in the Northflank console.

  • 02

    Will restarting a service cause downtime?

    Yes, if you are cycling replicas on a single-instance service. The AI performs the restart as requested, so you should manage this during maintenance windows if you don't have high availability configured.

  • 03

    Can the AI delete my services?

    No. There is no tool available to delete services or entire projects.

  • 04

    How does the AI know which service is failing?

    You tell the AI which service to look at, or it can scan your services using the available tools to find ones with errors.

  • 05

    Can the AI update my environment variables?

    No. The AI is limited to inspecting service data and restarting containers.

  • More questions about Northflank? The Connector page answers them. See everything the Northflank Connector can do

Connect Northflank to Claude, Cursor, ChatGPT & more