Immediate Value
By the end of this tutorial, every AI and integration setting at your firm will reflect a decision rather than a default — and you’ll have one page to come back to when compliance, IT or a partner asks “who can do what with our data?”Prerequisites
- Admin or Enterprise Admin. Some steps need a specific permission; each task says which.
- Tutorial 0.5 complete. Your team is invited and your roles are set. See Tutorial 0.5: Verify & Invite Your Team.
- Scale, Advanced, or Enterprise for Affinity AI, Affinity MCP and OAuth apps. Restricted Opportunities is Enterprise.
Quick-Start Roadmap
Why Governance Matters
More of your firm’s work now runs through AI — inside Affinity, and in the AI tools your team connects to it. The safeguards are built in: every agent and AI tool works with the permissions of the person using it, and nothing an agent suggests is written without a person approving it. What’s left for you is a handful of org-wide decisions. Make them once, on purpose, and write them down.Task 1: Decide Which AI Features Your Firm Uses, and Who Manages Them
Context
The Affinity AI settings page controls the core AI features — Ascend, Notetaker, Industry Insights and AI Chat — and the Labs program of experimental features. Every setting there is org-wide: on or off for the whole account.Action
- Go to Settings → Automations & AI → Affinity AI.
- On the Core Features tab, check each card — Ascend, Notetaker, AI Chat, Industry Insights — and click Edit to enable or disable it for your organization.
- On the Labs tab, decide whether your firm takes part in Labs, which Labs features are on, and whether newly released Labs features start on or off.
- Decide who else manages this page. Enterprise Admins always can; Admins can by default. Grant others the Manage Affinity AI feature access permission on the Users and Permissions page.
Orgs that use the Salesforce integration don’t see the Labs tab or the AI Chat card on this page.
Expected Outcome
Your firm’s AI features are on or off by decision, and you know who can change them.📚 Help Center
Task 2: Decide Which AI Tools Can Connect over MCP
Context
Affinity MCP lets your team use Affinity from Claude, ChatGPT, Notion and other AI tools. It’s available by default for Claude, ChatGPT and Notion. A connected AI tool sees what its user can see, and can update, delete and merge whatever its user can — deleting records, notes and fields, and every merge, shows what it will affect and waits for confirmation first.Action
- Go to Settings → Affinity MCP and turn each OAuth client on or off for your organization. Turning a client off disconnects everyone who connected it through OAuth.
- On Enterprise, decide which roles can change these toggles with the Manage MCP Agents permission, under Settings → Users & Permissions → Roles.
- Tell your team how to keep a connection read-only if they want one: uncheck the write scope on the OAuth consent screen when they first connect, or turn off the write, delete and merge tools in their AI client.
Expected Outcome
Only the AI tools your firm has approved can connect, and your team knows how to connect read-only.📚 Help Center
Task 3: Connect Integrations the Right Way: OAuth App or API Key
Context
Settings → Manage Apps holds both kinds of credentials, and picking the right one matters:- OAuth app — when a tool acts for individual people, and each person should sign in as themselves: an internal dashboard your deal team signs into, or an in-house assistant built on Affinity MCP. Nobody shares a key; each person approves the connection.
- API key — when a script or integration runs as one account in the background, such as a nightly data sync.
Action
Create an OAuth app (needs the Manage all OAuth apps permission; Admins and Enterprise Admins have it):- Ask the developer for the tool’s redirect URI and whether it runs on a server or on people’s own devices.
- Go to Settings → Manage Apps, click New App, and choose OAuth App.
- Fill in the form. Choose Client Type carefully — Public for a tool on people’s own devices, Confidential for one on a server you control. You can’t change it later.
- Give the app the fewest scopes that work.
- In Settings → Manage Apps, click + New App (then API Key, if a menu opens).
- Give each integration its own key, so you can revoke one without breaking the rest. Creating a new key doesn’t revoke the others.
Expected Outcome
Every integration at your firm uses the right kind of credential, and each one can be revoked on its own.📚 Help Center
- How to create and manage OAuth apps
- How to create and manage API keys
- How to audit API keys in your instance
Task 4: Set What Notetaker Keeps and Who Gets Its Emails
Context
Notetaker’s admin settings answer the questions compliance teams ask first: who can edit the notes, whether transcripts are kept, and who gets the summary email.Action
- Go to Settings → Automations & AI → Affinity AI, open the Notetaker card, and click Edit.
- Meeting note edit permissions — only the note’s creator (the default), or everyone from your team on the invite.
- Transcript retention — Retain transcripts (the default), or Do not retain transcripts, which deletes each transcript as soon as its summary note is created. The summary note is kept either way, and the change applies going forward only.
- Summary email recipients — everyone from your team on the invite (the default), only the people who requested Notetaker, only the meeting organizer, or no one. External participants never receive it.
- If you need a copy of every transcript, go to Settings → Data & Privacy → Export Data and click Export next to Export all meeting transcripts I have access to.
Whatever you choose, the third-party transcription service stores a transcript for 7 days before deleting it, to support data recovery. The note’s creator can also delete a single transcript from the note.
Expected Outcome
Notetaker’s editing, retention and email settings match your firm’s policy.📚 Help Center
Task 5: Follow API and MCP Usage
Context
The Usage page shows how your organization uses the Affinity API — including how much of the traffic comes from Affinity MCP — so you can spot the busiest users and apps before you reach a monthly limit.Action
- Make sure you have the View API usage permission. Enterprise Admins can grant it to other roles under Settings → Users and Permissions → Roles, in the APIs / Integrations section. Your plan must include API access.
- Go to Settings and, under Usage, click Usage. (If you can also see billing, the section is called Usage & Billing.)
- Read the Total Usage card for this month’s requests against your limit.
- Filter by user and by app to see who and what makes the most requests, and how much comes from MCP.
- If an app is noisy or unused, follow up with its owner — and revoke its key or OAuth app if nobody needs it (Task 3).
Expected Outcome
You know where your firm’s API and MCP traffic comes from, and you’d see a problem before it hits a limit.📚 Help Center
Task 6: Keep Sensitive Deals Restricted Automatically (Enterprise)
Context
Restricted Opportunities lets Enterprise firms mark sensitive deals so only people on each deal’s allow list see them; everyone else sees a masked row. Keeping allow lists in sync with deal teams by hand is where it breaks down — so let a person field do it.Action
- An Enterprise Admin allows restricted opportunities at Settings → Opportunities → Allowed Opportunity Types. (Turning it on disables the legacy Basic Reporting.)
- Go to Settings → Opportunities → Control Allowed Members from Field, and for each opportunity list choose the field that should control access — Owners, or a single- or multi-value person field such as Deal Team.
- From then on, adding or removing someone in that field updates their access automatically. The column shows a Controls Access badge, and the field can’t be deleted while it controls access.
Only internal people in the controlling field are granted access. AI tools and agents follow the same rules, because they always work with the permissions of the person using them.
Expected Outcome
Access to your sensitive deals follows your deal teams, with no separate list to maintain.📚 Help Center
Common Questions
Can I turn an AI feature on for some teams and not others?
Can I turn an AI feature on for some teams and not others?
No. Settings on the Affinity AI page are org-wide. Individual members still decide on Monitoring for the background agents, and anyone can keep their own MCP connection read-only.
Is our data used to train AI models?
Is our data used to train AI models?
No. Affinity’s contracts with its AI providers prohibit using your data to train their models. See Enabling Affinity Ascend and the Affinity Trust Center.
Does Affinity see what people ask their AI tools?
Does Affinity see what people ask their AI tools?
No. The Affinity MCP server is stateless and doesn’t see your prompts. See Affinity MCP security.