Your org's knowledge,
inside your AI — permanently.
Synaply speaks the open Model Context Protocol, connecting to any MCP-compatible AI assistant and giving it live access to your knowledge graph, organizational memory, insights, and enterprise search.
What the MCP Integration Does
Most AI assistants start from a blank slate every session. They don't know what your team decided last week, who owns the Acme account, or what process your ops team documented in March. Synaply's MCP integration fixes this.
Once connected, your AI can traverse your knowledge graph, search across every workspace source, read and write to your persistent memory, surface and share insights, and understand your org structure. All from inside your conversation, without switching apps.
The integration exposes 18 tools organized into four areas: Memory (persistent knowledge that follows you across sessions), Search (one unified search across your entire workspace — people, entities, decisions, documents, and outcomes), Insights (sharing and searching organizational learnings), and Identity (your profile and team structure).
Captured once, available everywhere your team works. Synaply doesn't replace your existing tools. It captures the knowledge produced inside them and makes it queryable across your entire AI stack via MCP.
How to Connect
Synaply works with any MCP-compatible client. The setup below shows the native connector flow. You need an active Synaply account. The full setup takes under two minutes.
- 1
Open your AI assistant's settings
Navigate to Settings, then Connectors (or the equivalent MCP server panel) in your AI client.
- 2
Add a New Connector
Click Add Connector and search for Synaply, or paste the MCP server URL provided by your admin.
- 3
Authenticate via OAuth
You'll be redirected to Synaply to authorize the connection. Log in with your Synaply credentials and approve the requested permissions.
- 4
Confirm the Connection
Return to your AI assistant with Synaply listed as active. All 18 tools are immediately available in your conversations.
- 5
Start Your First Session
Try: "What decisions have we made about X?" or "Remember that we chose Postgres over Mongo." Your assistant connects to your graph, memory, and insights instantly.
Want your AI to master all of this on day one? Download the knowledge skill →
What You Can Do With It
Once connected, these are the most common ways teams use Synaply through their AI assistant.
Query Your Knowledge Graph
Ask about any entity, relationship, or decision in your workspace. Your AI traverses the graph to connect the dots no single search could find.
Persistent AI Memory
Your AI remembers what matters across every session: decisions, preferences, war stories, and project context, all searchable and auto-curated.
Enterprise-Wide Search
One query searches across GitHub, docs, insights, memories, and people. No more switching tabs to track something down.
Decision Archaeology
Find not just what was decided, but who made the call, why, and what happened next. Trace the full decision-to-outcome arc.
Capture Knowledge As You Work
When a conversation produces a decision, lesson, or war story, your AI drafts it in your voice and — with your approval — publishes it as an insight for the team or saves it to your memory.
Onboarding and Context Transfer
New team members ask their AI to surface everything the org has captured about their role, accounts, and active projects, before their first meeting.
All 18 Tools
Every tool available through the Synaply MCP server. Required parameters marked ✱.
memory_indexMemoryLoads your memory index at session start, including always-loaded anchors and your top 30 most relevant memories.
memory_searchMemoryHybrid full-text and semantic search across your memories. Filterable by type, status, priority, and tags.
query ✱memory_getMemoryReturns a single memory in full, including body, why, and how-to-apply fields.
id ✱memory_createMemoryCreates a new memory: decision, war story, project, todo, feedback, reference, or user profile.
type ✱name ✱memory_updateMemoryUpdates an existing memory with field-level diffs and automatic revision tracking.
id ✱memory_archiveMemorySoft-archives a memory. Recoverable at any time.
id ✱memory_verifyMemoryConfirms a memory is still accurate and resets its staleness clock.
id ✱memory_list_revisionsMemoryLists the full revision history of a memory with per-source attribution.
id ✱synaply_searchSearchThe one tool for every workspace question. Hybrid keyword and semantic search across all connected sources — email, chat, files, code, calendar, CRM, and people — with exact identity, entity, decision, and relationship facets built in. Replaces the former separate enterprise-search, get-entity, get-relationships, and list-decisions tools.
synaply_read_document_fullSearchReturns the full indexed text of any search hit — title, deep link, and author included. Pass an optional query to search the entire document and return the matching passages.
sourceType ✱sourceId ✱synaply_read_documentsSearchThe batch form of read_document_full: read up to 20 documents in a single call by passing their source refs. Returns them in the same order, each with title, deep link, author, and text.
refs ✱synaply_get_outcomeSearchReturns terminal outcomes — merged PRs, closed issues, shipped or won work, plus success and failure retrospectives with sentiment. Each carries its artifact title and deep link.
synaply_explore_communitiesSearchThe thematic view above individual records: returns the knowledge graph's communities — clusters of densely-related people, companies, deals, and concepts — each with a generated theme summary and its top members. Use it for the landscape of your org's knowledge.
share_insightInsightsPublishes a lesson learned or piece of tacit knowledge into your workspace for your team to find.
content ✱title ✱search_insightsInsightsSearches published insights by free text, author, and date range.
query ✱list_insight_typesInsightsLists the workspace's insight-type catalog with form fields and guidelines per type.
get_user_identityIdentityReturns your user profile: name, email, designation, admin status, and timezone.
search_usersIdentityResolves a person's name to their user ID for use in filters and lookups.
name ✱How the Integration Is Secured
Synaply's MCP integration is built with security as a baseline, not an afterthought.
OAuth 2.0 authentication
All connections are established via standard OAuth 2.0. No passwords are exchanged. Your AI assistant receives a scoped access token that can be revoked at any time from your Synaply account settings or from the assistant's connector panel.
Encrypted transit
All data exchanged between Synaply's servers and your AI assistant provider travels over encrypted HTTPS connections.
Scoped access
The MCP integration only accesses data your account is already authorized to see. Existing role-based permissions and privacy levels are enforced on every tool call. A memory marked private is never returned to another user's session.
No AI training
Data accessed through the MCP integration is not used to train AI models, by Synaply or any third party.
Revocation
Disconnect the Synaply connector from your AI assistant's settings at any time. This immediately terminates the integration's access with no further action required.
Troubleshooting
My AI assistant says Synaply tools aren't available+
The connector may have been disconnected or the OAuth session expired. Go to your assistant's connectors panel and confirm Synaply shows as active. If listed but unresponsive, disconnect and reconnect to issue a fresh token.
Memory search returns no results+
If you haven't created any memories yet, there's nothing to find. Try creating one first ("Remember that we chose X because Y") and then searching for it. If you have memories but search returns nothing, try broader keywords or check that you're searching the right type filter.
Enterprise search doesn't find my documents+
Enterprise search covers content from connected sources (GitHub, docs, insights, memories). If a source isn't connected in your workspace, its content won't appear. Contact your admin to verify which integrations are active.
How do I revoke the connection?+
Disconnect the Synaply connector from your AI assistant's connectors panel. This immediately revokes the token and terminates access. You can also contact support@synaply.io to force-revoke all active tokens for your account.
Still stuck? Email support@synaply.io with your workspace name and a description of what you're seeing.
The Knowledge Skill
The MCP integration gives your AI the tools. The knowledge skill tells it exactly how to use them — the same playbook our own engine follows, packaged for your assistant.
Makes every company question a Synaply question. Teaches your AI exact person- and time-scoped search, when to widen, retry, and re-angle instead of giving up, reading full documents before answering — and spotting the decisions and lessons worth capturing back as insights and memories while you work.
To install: download the .skill file and upload it to your AI assistant's skills folder, or follow your team's skill installation process. The MCP connection must be active for the skill to work.