1. How SDK apps work
What an SDK app is
An SDK app is one game on MultiConnectCloud. It has one SDK key (mck- followed by 32 letters and digits), which goes into every build of the game.
Every feature in this guide belongs to the app. Its players, scores, saves and currencies are kept per app, so two games never share them.
Who may do what
Three kinds of caller talk to an SDK app. Each proves who it is in a different way, and each is allowed different things.
| Caller | Proves itself with | May |
|---|---|---|
| Anyone with the game | The SDK key, which is public: it ships inside the game | Read config, read leaderboards, read the store products, and sign in |
| A signed-in player | The SDK key plus a player session, which MultiConnectSDK gets at sign-in and sends for you | Read and change their own profile, read their own save and wallet, write their own save keys, claim the rewards the dashboard defines, buy coin store items at the catalog price, and delete their account |
| Your game server or game API | A server credential (section 6) | Everything a player may, for any player, plus everything that gives value: submitting scores, granting and spending currency, server-only save keys, task progress, sending messages and pushes, and bans |
The rule this table follows: a player's device can be modified by the player, so nothing that gives value is ever taken on the device's word.
- A client cannot submit a score unless you open that leaderboard to clients.
- A client cannot grant itself currency.
- When a client claims a reward or buys an item, it only says "claim" or "buy". MultiConnectCloud decides the amount from what you set on the dashboard.
Where each feature runs
| Feature | Set up on the dashboard | Called from the game client | Called from your server |
|---|---|---|---|
| Analytics (section 4) | Analytics | Automatic, plus McAnalytics.Track |
Automatic, plus McAnalytics.Track |
| Players and sign-in (section 5) | Sign-in and server access, Players | McApp, McAppAuth |
McAppServer (verify, ban, custom sign-in) |
| Remote config (section 7) | Remote config | McAppConfig |
McAppServer.GetConfigAsync |
| Leaderboards (section 8) | Leaderboards | McLeaderboards (read) |
McAppServer.SubmitScoreAsync |
| Cloud save (section 9) | Players > a player | McCloudSave |
McAppServer.SetPlayerDataAsync |
| Economy (section 10) | Economy | McAppWallet |
McAppServer.EconomyAsync, GrantAsync, SpendAsync, McAppServer.House |
| Daily rewards (section 11) | Daily rewards, Economy | McAppDailyBonus, McAppTasks, McAppAds |
McAppServer.AddTaskProgressAsync, SetPlayerLevelAsync |
| Inbox (section 12) | Inbox | McAppInbox |
McAppServer.SendMessageAsync |
| Store products and purchases (section 13) | Store products | McAppStore, McAppIap |
McAppServer.VerifyPurchaseAsync, GetStoreProductsAsync, VerifyWebhook |
| Errors (section 14) | Errors | Automatic, plus McAppErrors.Report |
McAppErrors.StartForServer |
| Push notifications (section 15) | Push notifications | McAppPush |
McAppServer.SendPushAsync |
All the client classes are in the MultiConnect.App namespace, except McAnalytics, which is in MultiConnect.
How dashboard settings apply
Most settings on an app's pages apply when you choose Save on their card, not while you type. A card with changes not yet saved shows Unsaved changes beside its Save button, and Saved · live once players get what it shows. Two things have their own step:
- Remote config keys go live when you Publish (section 7).
- Store products reach the stores when you Plan and Apply (section 13).
Times are UTC. Every time you enter on these pages (a push's send time, an inbox message's start, the end of maintenance) is in UTC, and every time shown is UTC with "UTC" after it. Under each time you type, the page shows the same moment in your own time zone, e.g. "Your time: 20 Nov 2026, 8:00 pm IST", so there's nothing to convert by hand.
How results come back
No call in this guide throws into your game.
- Every call returns an
McAppResult, or anMcAppResult<T>that carries aValue. - Check
Okfirst. - When
Okis false,Errorsays why (the full list is in section 17) andMessageis a sentence you can log or show to the player.

