Skip to main content

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

  1. Go to Settings → Automations & AI → Affinity AI.
  2. 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.
  3. 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.
  4. 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

  1. 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.
  2. On Enterprise, decide which roles can change these toggles with the Manage MCP Agents permission, under Settings → Users & Permissions → Roles.
  3. 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.
Grant broad list access carefully to people who will connect AI tools. An AI tool can reach everything its user can.

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):
  1. Ask the developer for the tool’s redirect URI and whether it runs on a server or on people’s own devices.
  2. Go to Settings → Manage Apps, click New App, and choose OAuth App.
  3. 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.
  4. Give the app the fewest scopes that work.
Create an API key:
  1. In Settings → Manage Apps, click + New App (then API Key, if a menu opens).
  2. Give each integration its own key, so you can revoke one without breaking the rest. Creating a new key doesn’t revoke the others.
Revoking an API key or OAuth app breaks anything using it immediately. Confirm with the integration’s owner first.

Expected Outcome

Every integration at your firm uses the right kind of credential, and each one can be revoked on its own.

📚 Help Center


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

  1. Go to Settings → Automations & AI → Affinity AI, open the Notetaker card, and click Edit.
  2. Meeting note edit permissions — only the note’s creator (the default), or everyone from your team on the invite.
  3. 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.
  4. 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.
  5. 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

  1. 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.
  2. Go to Settings and, under Usage, click Usage. (If you can also see billing, the section is called Usage & Billing.)
  3. Read the Total Usage card for this month’s requests against your limit.
  4. Filter by user and by app to see who and what makes the most requests, and how much comes from MCP.
  5. 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

  1. An Enterprise Admin allows restricted opportunities at Settings → Opportunities → Allowed Opportunity Types. (Turning it on disables the legacy Basic Reporting.)
  2. 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.
  3. 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

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.
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.
No. The Affinity MCP server is stateless and doesn’t see your prompts. See Affinity MCP security.

What’s Next

With governance in place, help your team get value from it: set up the agents your firm’s way in Make Affinity AI Work Your Firm’s Way, and share Private-Capital Skills in Your AI Tool with the people who connect AI tools.