Skip to main content

Connect internal company knowledge to ChatGPT and Claude

This tutorial shows you how to connect your Kapa internal MCP server to ChatGPT or Claude, enabling your team to access company knowledge directly inside their AI assistant.

This integration is designed for internal teams who need quick access to documentation and knowledge bases while working. Access is restricted to employees with Kapa accounts who have the appropriate permissions, ensuring your internal information stays secure.

By the end of this tutorial, members of your organization will be able to ask questions about your product and internal resources directly in ChatGPT or Claude, with responses grounded in your company's knowledge sources.

Prerequisites​

To follow this tutorial you need:

  • A Kapa project with a Hosted MCP server configured, using the Internal authentication type.
  • Some knowledge sources connected to that project.
  • A Kapa account with the Use Internal Chat Assistant permission for the project (see Roles and permissions).
  • An AI assistant subscription:
    • ChatGPT: available on Business, Enterprise, and Education plans.
    • Claude: available on Pro, Max, Team, or Enterprise plans. Team and Enterprise plans require additional setup steps by owners before individuals can connect.

Authentication and security​

You must configure your Kapa MCP server with the Internal authentication type.

If you're unsure about your authentication configuration, check it in your Kapa project settings under Integrations > Hosted MCP Server before proceeding.

When a user connects to your internal MCP for the first time, they are directed to the Kapa login page. The user then logs in with their Kapa account, using whichever authentication methods permitted for your Kapa instance.

To access the internal MCP server, the user account must have the Use Internal Chat Assistant permission for the project. Refer to Roles and permissions for more information on managing project permissions.

Step 1: Connect your MCP server​

Note

Developer mode and full MCP support are currently in beta for ChatGPT. Features and UI may change.

An admin or owner needs to create and publish a custom MCP app for your organization.

Admin or owner setup:

  1. Make sure developer mode is enabled. Navigate to Settings > Apps > Advanced Settings to check and enable this setting.
  2. Navigate to Workspace Settings > Apps > Create.
  3. Provide your MCP server details:
    • Name: This will be the name of the app in the interface.
    • MCP Server URL: Your Kapa MCP server URL. You can find this in Kapa under Integrations > Hosted MCP Server. Format: https://your-subdomain.mcp.kapa.ai.
    • Authentication: OAuth. Leave the Client ID and Client Secret empty.
  4. Click Create.
  5. Go through the Kapa authentication flow. When complete, the app appears as a draft in Workspace Settings > Apps > Drafts.
  6. Test the app:
    1. Open a new chat.
    2. Select your draft app from the tools menu.
    3. Test with questions about your documentation.
    4. You should see ChatGPT using the search_<CUSTOMER_PRODUCT_NAME>_knowledge_sources tool.
  7. Publish the app:
    1. Go to Workspace Settings > Apps > Drafts.
    2. Click Publish.
    3. Review safety warnings.
    4. Click Publish.
    5. Enterprise and Education: Configure access control using RBAC and select which actions the app can perform.

Team members can now connect to the Kapa app you created:

  1. Open the ChatGPT web interface.
  2. Go to Settings > Apps.
  3. Find and click the Kapa connector in the list.
  4. Click Connect.
  5. Complete the Kapa login authentication flow.

You must manually select the Kapa app to make it available in each chat:

  1. In a chat, open the tools menu (+ icon).
  2. Select More > your Kapa app.

Step 2: Verify the connection​

Once connected, verify it's working:

  1. Start a new chat.
  2. Type a question about your internal documentation.
  3. Verify the responses include information from your knowledge sources. You can also check that your AI is using the search_<CUSTOMER_PRODUCT_NAME>_knowledge_sources tool.

Troubleshooting​

ChatGPT: I created an app, but can't see it​

Make sure you are on a Business, Enterprise, or Education plan. Individual plans can go through an app creation process, and will get a success message when connecting the Kapa MCP, but the rollout of this feature is incomplete in ChatGPT. The app won't show up on your apps list or be available in your chats.