AI Assistant vs the MCP Server

Code Effects offers two ways for AI to work with your rules, and they answer different needs:

  • The in-app AI: the AI Assistant and the AI Rule Editor, built into the Rule Repository's own screens. Your server calls a model you choose, with your keys, for whoever uses RR. See The AI Assistant and the AI Rule Editor.
  • The MCP server: a Model Context Protocol endpoint in your application. People connect the AI clients they already use (Claude, an AI coding tool, your own agents) to it, sign in with your company's identity provider, and their AI works with your rules from there. See MCP Server.

Both reach your rules through the same tools, the same permission checks and the same rules for agents: an AI never makes a version live, takes one offline, approves, declines or deletes, and everything it saves waits for a person's approval. What differs is who runs the model, who pays for it, where people use it, and what you have to set up.

Side by Side

In-app AI (AI Assistant, AI Rule Editor) MCP server
Where people use it Inside RR, in the browser, beside the rules they are looking at In their own AI client: Claude on the web, desktop or phone, an AI coding tool, or your own agents
Who runs the model Your server, through the client you register (Anthropic, OpenAI, Azure OpenAI, a model on your own hardware, any IChatClient) The AI client's vendor, with the model the person or their organization chose there
Who pays for the model You, on your vendor account, per token. You can set prices, see usage and enforce quotas (OnUsage, CanStep) Whoever pays for the AI client (usually each person's or your organization's subscription). Your server pays nothing per token
Where the data goes To the vendor you chose, under your contract, or nowhere if the model runs on your hardware To the AI client's vendor, under the person's or organization's agreement with it
Sign-in None extra: the person is already signed in to your application, and RR's endpoint uses that OAuth through your identity provider (Microsoft Entra ID, Okta, Auth0 ...). Each AI client is registered with it, and the server must be reachable from the AI vendor's cloud when the client runs there
What you build A few lines: register the models, set Assistant on the RR configuration An ASP.NET Core (.NET 8) endpoint, token validation, the protected resource metadata, a mapping from the token to a user and permissions
Runs on Wherever RR runs: .NET Framework or .NET .NET 8 or later, ASP.NET Core only
Needs RR's user interface Yes: it lives in RR's screens No: works with the Rule Repository library, Audit, or both, with or without RR's screens
Tools The same tools, loaded in groups as the conversation needs them; the AI Rule Editor has a fixed set that saves nothing Every tool the caller's permissions allow, listed per caller
Context Knows where the person is: the AI Rule Editor starts with the rule, draft or version on screen Starts from nothing; the person names the rule or source
Confirmations (a test that calls production code) A card in the conversation; the person answers there The client asks the person if it supports it; otherwise the agent must ask and call a separate confirming tool
Files Attachments in the AI Assistant (PDF, images, text), kept where you decide Whatever the AI client supports; the client reads them, not your server
History Conversations stored in RR's database for 90 days by default; administrators with permission 112 can read every user's Kept by the AI client, not by your application
Activity Every save names the person and the agent (by default "AI Assistant") Every save names the person and the AI client the token was issued to
Automation with no person No Yes: a service or an agent of your own can sign in with client credentials or a key and run, for example, nightly test runs
Skills Built in: RR loads the skill for each group of tools Served by the server; clients that load skills over MCP get them, and the server's instructions carry the essentials for the rest

When to Use Which

The in-app AI alone suits most organizations starting out:

  • Business users work in RR every day and want help right there, on the rule in front of them.
  • You want one bill, one vendor contract and one place to set quotas.
  • Your data must not reach a vendor your organization has not approved, or must stay on your own hardware.
  • You do not want to register AI clients with your identity provider or open your server to an AI vendor's cloud.

The MCP server alone suits organizations whose people already live in an AI client:

  • Analysts and developers use Claude or an AI coding tool all day and want the rules there, next to their documents, mail and code.
  • You do not want to pay per token for rule work, or your organization's AI subscription already covers it.
  • You use Audit without RR's screens and want AI to analyze production decisions.
  • You want your own automation (a nightly job, a CI pipeline, your own agent) to read rules, run tests and report.

Both is common and costs nothing extra in design: the two share the tools, the permissions and the agent settings, so they cannot disagree. Typical reasons:

  • Business users get the in-app AI; analysts and developers connect their own clients.
  • People write and check rules in RR with the AI Rule Editor, and investigate production decisions from their AI client, next to the tickets and mails that prompted the question.
  • A person reviews and approves in RR what an agent prepared over MCP.

Neither: RR works fully without AI. Register no models and do not map the MCP endpoint.

Decision Table

Your situation Choose
Users work in RR's screens and need help writing rules In-app AI
Data may only go to a vendor you contract, or must stay in-house In-app AI (with that vendor, or a model on your hardware)
Users already have Claude or another MCP client MCP server
No per-token costs on your side MCP server
Audit without RR's screens MCP server
Automation with no person (CI, scheduled checks) MCP server, with a service caller
Your application runs on .NET Framework In-app AI (the MCP server needs .NET 8; it can run in a separate .NET 8 application on the same database)
Both groups of people Both

Setting Up Both

  1. Set up RR and its endpoint first (Implementation Checklist).
  2. For the in-app AI, register models and grant 110 and 111: The AI Assistant and the AI Rule Editor.
  3. For the MCP server, add it to an ASP.NET Core application on the same database: Setting Up the MCP Server, then Authentication and the Caller.
  4. Set the agent settings once, so both follow the same limits: on the RR configuration (Configuration.Agents) and, for the MCP server, in RepositoryMcpOptions.Configure.
  5. Give the same person the same permissions in both: build the RR configuration's permission set and the MCP caller's from the same source (your roles or groups).
  6. Tell users how to connect: Connecting Users to Your MCP Server.

Ask on Stack Overflow - Yes, it's still active
Ask in GitHub Discussions

p102

l097 --

l102

p101

×