add AdaL CLI installation instructions

Author: Abdulrahmansoliman

README.md

@@ -81,6 +81,7 @@ Alternatively, to manually configure VS Code, choose the appropriate JSON block
 
 ### Install in other MCP hosts
 
+- **[AdaL CLI](/docs/installation-guides/install-adal-cli.md)** - Installation guide for AdaL CLI
 - **[Copilot CLI](/docs/installation-guides/install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
 - **[GitHub Copilot in other IDEs](/docs/installation-guides/install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
 - **[Claude Applications](/docs/installation-guides/install-claude.md)** - Installation guide for Claude Desktop and Claude Code CLI
@@ -351,6 +352,7 @@ Optionally, you can add a similar example (i.e. without the mcp key) to a file c
 
 For other MCP host applications, please refer to our installation guides:
 
+- **[AdaL CLI](docs/installation-guides/install-adal-cli.md)** - Installation guide for AdaL CLI
 - **[Copilot CLI](docs/installation-guides/install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
 - **[GitHub Copilot in other IDEs](/docs/installation-guides/install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
 - **[Claude Code & Claude Desktop](docs/installation-guides/install-claude.md)** - Installation guide for Claude Code and Claude Desktop

docs/installation-guides/README.md

@@ -3,6 +3,7 @@
 This directory contains detailed installation instructions for the GitHub MCP Server across different host applications and IDEs. Choose the guide that matches your development environment.
 
 ## Installation Guides by Host Application
+- **[AdaL CLI](install-adal-cli.md)** - Installation guide for AdaL CLI
 - **[Copilot CLI](install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
 - **[GitHub Copilot in other IDEs](install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
 - **[Antigravity](install-antigravity.md)** - Installation for Google Antigravity IDE
@@ -16,6 +17,7 @@ This directory contains detailed installation instructions for the GitHub MCP Se
 
 | Host Application | Local GitHub MCP Support | Remote GitHub MCP Support | Prerequisites | Difficulty |
 |-----------------|---------------|----------------|---------------|------------|
+| AdaL CLI | ✅ | ✅ PAT + ❌ No OAuth | Docker, GitHub PAT | Easy |
 | Copilot CLI | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
 | Copilot in VS Code | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: VS Code 1.101+ | Easy |
 | Copilot Coding Agent | ✅ | ✅ Full (on by default; no auth needed) | Any _paid_ copilot license | Default on |

docs/installation-guides/install-adal-cli.md

@@ -0,0 +1,80 @@
+# Install GitHub MCP Server in AdaL CLI
+
+## Prerequisites
+
+1. AdaL CLI installed — `npm install -g @sylphai/adal-cli` (requires Node.js 20+)
+2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new) with appropriate scopes
+
+## Option 1 — Shortcut (Easiest)
+
+AdaL CLI has a pre-configured shortcut for GitHub. Set your token before starting AdaL, then add the server:
+
+```bash
+# macOS / Linux
+export GITHUB_TOKEN="ghp_xxxx"
+
+# Windows (PowerShell)
+$env:GITHUB_TOKEN="ghp_xxxx"
+```
+
+Then inside your AdaL session:
+
+```bash
+/mcp add github
+```
+
+AdaL reads the `GITHUB_TOKEN` environment variable at startup. See [AdaL CLI MCP docs](https://docs.sylph.ai/features/mcp-support-proposed) for more info.
+
+## Option 2 — Remote GitHub MCP Server
+
+Connect directly to GitHub's hosted MCP server at `https://api.githubcopilot.com/mcp/` using a PAT header.
+
+<details>
+<summary>AdaL CLI Remote Server Connection</summary>
+
+```bash
+/mcp add github --transport http --url https://api.githubcopilot.com/mcp/ --header "Authorization:Bearer YOUR_GITHUB_PAT"
+```
+
+Replace `YOUR_GITHUB_PAT` with your actual [GitHub Personal Access Token](https://github.com/settings/tokens).
+
+</details>
+
+## Option 3 — Local GitHub MCP Server (Docker)
+
+Run the server locally using Docker.
+
+### Prerequisites
+
+- [Docker](https://www.docker.com/) installed and running
+- [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new) with appropriate scopes
+
+<details>
+<summary>AdaL CLI Local Server Connection</summary>
+
+```bash
+/mcp add github --command docker --args "run,-i,--rm,-e,GITHUB_PERSONAL_ACCESS_TOKEN,ghcr.io/github/github-mcp-server" --env "GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT"
+```
+
+Replace `YOUR_GITHUB_PAT` with your actual [GitHub Personal Access Token](https://github.com/settings/tokens).
+
+</details>
+
+## Verify the Connection
+
+After adding the server, test it inside AdaL:
+
+```
+/mcp
+```
+
+Select the `github` server → **Test Connection**. You should see the available GitHub tools listed.
+
+## Troubleshooting
+
+- **"Connection failed"** — Verify your PAT is valid and has the required scopes (`repo`, etc.)
+- **Token not read (shortcut)** — Make sure `GITHUB_TOKEN` is set *before* starting AdaL; restart required if set after launch
+- **Docker errors** — Ensure Docker is running: `docker ps`
+- **Token not found (local)** — Confirm your PAT is correctly set in the `--env` flag
+
+For more details, see the main [README.md](../../README.md).