> For the complete documentation index, see [llms.txt](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/getting-started/discord-setup.md).

# Discord Integration

MT5 Link can read signals from Discord channels in addition to Telegram. Switch between sources with the mode selector.

***

## How It Works

A Discord bot sits in your signal channel and forwards messages to MT5 Link. The same signal parser and execution engine handle both Telegram and Discord — no duplicate configuration needed.

***

## Setting Up Discord Mode

### Step 1: Get Your Bot Token

Use the token provided with your subscription (delivered after purchase). This is a shared bot — you don't need to create one yourself.

### Step 2: Get Your Channel ID

1. Open Discord
2. Go to **User Settings → Advanced**
3. Enable **Developer Mode**
4. Right-click your signal channel → **Copy ID**

### Step 3: Enter Credentials

1. Open MT5 Link
2. Click **Discord** on the mode toggle (top of config panel)
3. Paste your **Bot Token** and **Channel ID**
4. Click **Test Discord Connection** to verify

If the test succeeds, status shows "Connected". If it fails, check that the bot has access to the channel.

***

## Mode Lock

The mode selector locks automatically when you click **Save & Start**. Locked mode prevents accidental source changes while running.

* **Locked** → red lock icon
* **Unlock** → use the trash button to reset (wipes current mode's credentials)

***

## Testing

### Test Discord Connection

Verifies that the bot token and channel ID are valid. Shows success/failure below the button.

### Test Signal (dry-run)

Opens a dialog where you can paste any signal (Telegram or Discord format), parse it, and see what order MT5 Link would send — without actually placing a trade.

Useful for:

* Testing new signal formats
* Verifying parser recognizes your provider's messages
* Checking calculated lot size before going live

***

## Switching Between Sources

| Source       | When to Use                                      |
| ------------ | ------------------------------------------------ |
| **Telegram** | Your signal provider posts in a Telegram channel |
| **Discord**  | Your signal provider posts in a Discord channel  |

Both modes share the same risk settings, symbol mappings, and MT5 connection. Only the signal source changes.

***

## Troubleshooting

### Test Connection Fails

1. Ensure the Discord bot token is correct
2. Ensure the channel ID is correct (right-click → Copy ID)
3. Make sure the bot has been invited to the channel
4. Check the diagnostics log for error details

### Signals Not Executing

1. Run **Test Signal** with a message from your provider — confirms parsing works
2. Check the status pills in the account bar: Signal should be green
3. Verify MT5 is connected and logged into your trading account

### Bot Shows Offline

* The shared bot occasionally restarts for maintenance
* Wait a few seconds — it reconnects automatically
* If offline > 1 minute, check the log for errors


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mt5-m0rpheu5.gitbook.io/mt5.m0rpheu5-docs/getting-started/discord-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.