Documentation

Samong is a visual, infinite-canvas app for your knowledge — a place where reading becomes thinking. ("Samong", สมอง, means "brain" in Thai.) Instead of filing notes away in folders, you lay them out in space and connect them like a map.

Your workspace is built from four kinds of content, all living on canvases you can pan and zoom:

• Whiteboards — infinite canvases where you arrange and connect ideas. Create and browse them from the Whiteboards gallery.
• Cards — every note is a card. Write in rich text and connect cards to each other with `[[wikilinks]]`.
• Journal — a dated space for daily notes and thinking.
• PDFs — drop a PDF onto a board to read it inside Samong and pull highlights straight into cards.

A whiteboard is an endless surface. Scroll or pinch to zoom, drag the background to pan, and drag nodes to move them. Double-click empty space to drop a new card, or use the toolbar to add other kinds of nodes.

Beyond cards, boards hold text blocks, sections (grouping areas), images, shapes, links, and embedded media — plus two structural nodes worth knowing:

Mindmaps

Branch an idea into a tree and Samong lays it out automatically. Drag a branch and its whole subtree comes along, so you can restructure your thinking with a single gesture.

Sub-whiteboards

Drop a board reference to nest one whiteboard inside another. Double-click it to descend, and follow the trail chip back up — useful for breaking a big map into focused sub-maps.

Open a PDF from a board to read it in the side panel. The reader has two tools you switch in its toolbar:

• Cursor — the default. Drag over text to select it, drag on empty space to draw a region box, or click an existing highlight or region to manage it.
• Region select — a crosshair mode that always draws a region box, handy for figures and scanned pages.

Select a passage or region, then Extract to card. Samong creates a card with the text and a source link back to the exact page — double-click the source badge on a card any time to jump straight there.

From the AI button in the PDF panel, Samong can turn a document into knowledge for you:

• PDF → mindmap — a Buzan-style mindmap of a page range, dropped onto your canvas.
• PDF → summary card — a concise markdown summary as a new card.
• Chat with a PDF — ask questions about the pages you select.

Each AI action spends credits from your monthly allowance (Free includes 10 per month; Pro includes 500). Short documents cost 1 credit and longer page ranges cost a little more — always shown before you spend. Your remaining credits appear in the sidebar.

Share any whiteboard with a link — as view-only or can-edit — from the board’s share menu. Editors co-edit in real time: changes sync live and conflict-free, and you can see each other’s cursors and presence.

You can also invite people to your workspace as members so they can collaborate across your boards. Shared boards appear in the recipient’s “Shared with me” gallery.

MCP (the Model Context Protocol) lets AI assistants like Claude securely read and work with your Samong knowledge — only after you grant permission. Connect a client once and it can search your workspace, read your cards and whiteboards, and, if you allow it, create new cards for you.

What you’ll need

• An MCP-capable client that supports remote connectors — for example, the Claude desktop app.
• To be signed in to Samong in your browser (the connection is authorized on a Samong consent page).

Your connection URL

This is the single address you paste into your AI client. Everything else — sign-in, permissions, and the secure OAuth handshake — happens automatically.

Connect the Claude desktop app

1. 1Open Claude → Settings → Connectors.
2. 2Click Add custom connector.
3. 3Paste your Samong connection URL from above and confirm.
4. 4Your browser opens a Samong consent page — sign in if you’re prompted.
5. 5Choose the one workspace the assistant may access, review the permissions it’s asking for, then click Allow.
6. 6That’s it — Claude can now use Samong’s tools to help you.

What the assistant can do

Every connection is limited to the single workspace you pick, and to one of two permission levels:

• Read — search your workspace and read your cards, whiteboards, journal entries, and PDF names.
• Write — everything above, plus create new note cards and append to your journal. It never edits or deletes your existing content.

Under the hood the assistant gets focused tools: full-text search, listing and reading whiteboards (as compact text outlines) and cards, following a card’s `[[wikilinks]]`, and reading journal entries by date.

Good to know

• A connection can only touch the one workspace you approved — nothing else in your account is visible to it.
• PDF file contents aren’t readable over MCP yet — PDFs currently appear by name in search results only.
• Large results are trimmed to keep the assistant fast and focused; if something looks cut off, ask it to search or page through.

Managing & revoking connections

See every connected assistant — with its workspace and last-used date — under Settings → Connected AI apps. Disconnect removes access immediately.

Manage your plan, storage, and AI credits from the sidebar meter and Settings. Free covers up to 1,000 cards, 10 whiteboards, 500 MB of storage, and 10 AI credits a month; Pro raises those limits and adds 500 AI credits, 50 GB, and larger live-collaboration boards.

Your data is always yours — export cards as Markdown and whiteboards as PNG, SVG, or PDF whenever you like. No lock-in.

Hit a bug, or have an idea? Use the Feedback button in the top bar to send a report (you can attach screenshots), or email us at [email protected].

Samong is in active beta and we read and reply to everything — your feedback shapes what we build next.