Instalar o servidor MCP do Kshana (v0.40.0)

Consultivo, não é um equipamento de navegação homologado: o operador continua responsável pela navegação. O servidor roda no seu computador; nada é enviado à Ashforde OÜ.

Todos os canais, com a forma fixada para esta versão. Os links de um clique e todos os trechos abaixo são gerados por scripts/gen_mcp_install.py e decodificados de volta por scripts/test_gen_mcp_install.py.

Todos os canais#

Escolha uma forma de iniciar o servidor#

Cada cliente abaixo aceita uma de três definições de servidor. Elas iniciam o mesmo servidor:

• npx (Node) (requer Node 18+): npx -y kshana-mcp@0.40.0
• Docker (requer Docker): docker run -i --rm ghcr.io/ashfordeou/kshana-mcp:0.40.0
• kshana-mcp no PATH (requer o binário (brew, scoop, winget, cargo ou um download da versão)): kshana-mcp

Links de um clique#

• Cursor, npx (Node): link da web · cursor://anysphere.cursor-deeplink/mcp/install?name=kshana&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImtzaGFuYS1tY3BAMC40MC4wIl19
• Cursor, Docker: link da web · cursor://anysphere.cursor-deeplink/mcp/install?name=kshana&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCJnaGNyLmlvL2FzaGZvcmRlb3Uva3NoYW5hLW1jcDowLjQwLjAiXX0=
• Cursor, kshana-mcp no PATH: link da web · cursor://anysphere.cursor-deeplink/mcp/install?name=kshana&config=eyJjb21tYW5kIjoia3NoYW5hLW1jcCIsImFyZ3MiOltdfQ==
• VS Code, npx (Node): abrir · Insiders
• VS Code, Docker: abrir · Insiders
• VS Code, kshana-mcp no PATH: abrir · Insiders
• Goose, npx: goose://extension?cmd=npx&arg=-y&arg=kshana-mcp%400.40.0&timeout=300&id=kshana&name=Kshana&description=Kshana%20PNT-resilience%20simulator%20%28advisory%29

Outro cliente

/plugin marketplace add ashfordeOU/kshana
/plugin install kshana@ashforde

Configuração de cada cliente#

Outro cliente

Onde: execute em um terminal (acrescente --scope user para todo projeto). Ou o plugin abaixo.

npx (Node):

Uma passagem que nomeia clientes de IA de terceiros fica de fora aqui; ela está em docs/MCP-INSTALL.md no GitHub.

Docker:

Uma passagem que nomeia clientes de IA de terceiros fica de fora aqui; ela está em docs/MCP-INSTALL.md no GitHub.

kshana-mcp no PATH:

Uma passagem que nomeia clientes de IA de terceiros fica de fora aqui; ela está em docs/MCP-INSTALL.md no GitHub.

Outro cliente

Onde: claude_desktop_config.json (Configurações, Desenvolvedor, Editar configuração). Ou dê um clique duplo na extensão .mcpb da versão: sem arquivo de configuração.

npx (Node):

{
  "mcpServers": {
    "kshana": {
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

Docker:

{
  "mcpServers": {
    "kshana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

kshana-mcp no PATH:

{
  "mcpServers": {
    "kshana": {
      "command": "kshana-mcp",
      "args": []
    }
  }
}

Cursor#

Onde: ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto).

npx (Node):

{
  "mcpServers": {
    "kshana": {
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

Docker:

{
  "mcpServers": {
    "kshana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

kshana-mcp no PATH:

{
  "mcpServers": {
    "kshana": {
      "command": "kshana-mcp",
      "args": []
    }
  }
}

VS Code#

Onde: .vscode/mcp.json. Ou code --add-mcp com o mesmo objeto mais um name.

npx (Node):

{
  "servers": {
    "kshana": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

Docker:

{
  "servers": {
    "kshana": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

kshana-mcp no PATH:

{
  "servers": {
    "kshana": {
      "type": "stdio",
      "command": "kshana-mcp",
      "args": []
    }
  }
}

Windsurf#

Onde: mcp_config.json (abra-o a partir das configurações de MCP do Cascade).

npx (Node):

{
  "mcpServers": {
    "kshana": {
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

Docker:

{
  "mcpServers": {
    "kshana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

kshana-mcp no PATH:

{
  "mcpServers": {
    "kshana": {
      "command": "kshana-mcp",
      "args": []
    }
  }
}

Zed#

Onde: settings.json.

npx (Node):

{
  "context_servers": {
    "kshana": {
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

Docker:

{
  "context_servers": {
    "kshana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

kshana-mcp no PATH:

{
  "context_servers": {
    "kshana": {
      "command": "kshana-mcp",
      "args": []
    }
  }
}

Goose#

Onde: ~/.config/goose/config.yaml.

npx (Node):

extensions:
  kshana:
    name: Kshana
    type: stdio
    cmd: npx
    args: ["-y", "kshana-mcp@0.40.0"]
    enabled: true
    timeout: 300

Docker:

extensions:
  kshana:
    name: Kshana
    type: stdio
    cmd: docker
    args: ["run", "-i", "--rm", "ghcr.io/ashfordeou/kshana-mcp:0.40.0"]
    enabled: true
    timeout: 300

kshana-mcp no PATH:

extensions:
  kshana:
    name: Kshana
    type: stdio
    cmd: kshana-mcp
    args: []
    enabled: true
    timeout: 300

Codex CLI#

Onde: execute em um terminal, ou ~/.codex/config.toml.

npx (Node):

codex mcp add kshana -- npx -y kshana-mcp@0.40.0

# or in config.toml:
[mcp_servers.kshana]
command = "npx"
args = ["-y", "kshana-mcp@0.40.0"]

Docker:

codex mcp add kshana -- docker run -i --rm ghcr.io/ashfordeou/kshana-mcp:0.40.0

# or in config.toml:
[mcp_servers.kshana]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/ashfordeou/kshana-mcp:0.40.0"]

kshana-mcp no PATH:

codex mcp add kshana -- kshana-mcp

# or in config.toml:
[mcp_servers.kshana]
command = "kshana-mcp"
args = []

Gemini CLI#

Onde: ~/.gemini/settings.json, ou gemini mcp add.

npx (Node):

{
  "mcpServers": {
    "kshana": {
      "command": "npx",
      "args": [
        "-y",
        "kshana-mcp@0.40.0"
      ]
    }
  }
}

# or:
gemini mcp add kshana npx -- -y kshana-mcp@0.40.0

Docker:

{
  "mcpServers": {
    "kshana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ashfordeou/kshana-mcp:0.40.0"
      ]
    }
  }
}

# or:
gemini mcp add kshana docker -- run -i --rm ghcr.io/ashfordeou/kshana-mcp:0.40.0

kshana-mcp no PATH:

{
  "mcpServers": {
    "kshana": {
      "command": "kshana-mcp",
      "args": []
    }
  }
}

# or:
gemini mcp add kshana kshana-mcp

Continue#

Onde: .continue/mcpServers/kshana.yaml.

npx (Node):

name: Kshana
version: 0.0.1
schema: v1
mcpServers:
  - name: kshana
    command: npx
    args:
      - "-y"
      - "kshana-mcp@0.40.0"

Docker:

name: Kshana
version: 0.0.1
schema: v1
mcpServers:
  - name: kshana
    command: docker
    args:
      - "run"
      - "-i"
      - "--rm"
      - "ghcr.io/ashfordeou/kshana-mcp:0.40.0"

kshana-mcp no PATH:

name: Kshana
version: 0.0.1
schema: v1
mcpServers:
  - name: kshana
    command: kshana-mcp
    args: []

Uso remoto#

kshana-mcp --http <addr> serve as mesmas ferramentas por HTTP em fluxo contínuo para um cliente que não pode executar um processo local. É para hospedagem própria; a Ashforde OÜ não opera um endpoint público. Veja deploy/mcp-http.md.