Introduction

Connect your AI assistant to the Intershop Knowledge Base to search documentation and fixed issues directly from your development workflow. Choose one of the client setup options below. Then verify the connection with a first question.

Prerequisites

• An Intershop support contract or partner support contract and your Intershop Customer Service Portal login

• A client that supports MCP (Model Context Protocol) and Streamable HTTP

• An AI model configured for tool use

• Permission from your organization to connect the client to an external MCP server

Use these connection settings:

When you connect for the first time, your client opens the Intershop sign-in page. Sign in with your Intershop Customer Service Portal login. If sign-in fails, contact Intershop Customer Support or the Intershop Partner Team.

The Documentation MCP is read-only. It searches and reads only the Intershop Knowledge Base and has no access to your code, files or systems. The server receives only the search queries and document requests that your AI assistant sends to it. Your client determines which AI model processes the results.

Option 1: GitHub Copilot in Visual Studio Code

1. Open your project in VS Code with GitHub Copilot configured.

2. Open the Command Palette and run MCP: Add Server.

3. Choose HTTP.

4. Enter the server URL stated above and use intershop-docs as the server name.

5. Choose the configuration destination offered by your VS Code version.

6. Trust the server, when prompted, and sign in with your Intershop Customer Service Portal login.

7. Open a Copilot agent session

8. Make the server's tools available to it.

For a workspace using .vscode/mcp.json, the connection configuration is:

{
  "servers": {
    "intershop-docs": {
      "type": "http",
      "url": "https://docs.mcp.intershop.com/mcp"
    }
  }
}

If the file already contains other servers, add only the intershop-docs entry under servers. Configuration locations vary by VS Code version. Prefer the guided setup. For details, see VS Code | Add MCP servers.

Option 2: Claude Code

1. Open a terminal in your project directory.

2. Register the server:

   claude mcp add --transport http intershop-docs https://docs.mcp.intershop.com/mcp

3. Start Claude Code in that project.

4. Enter /mcp.

5. Select intershop-docs.

6. Choose Authenticate.

7. Sign in with your Intershop Customer Service Portal login in the browser window that opens.

8. Enter /mcp again and check that intershop-docs is shown as connected.

This command uses the default local scope for the current project. For details, see Claude Code | Connect to tools via MCP.

Option 3: Microsoft Copilot Studio

1. Open Copilot Studio.

2. Open or create your agent and ensure that generative orchestration is enabled.

3. Go to Tools | Add a tool | New tool | Model Context Protocol.

4. Enter intershop-docs as the name and the server URL stated above.

5. Add a description, for example: “Search Intershop documentation and fixed issues, and retrieve full articles for product and development questions.”

6. Select OAuth 2.0 with the type Dynamic discovery under Authentication.

7. Create a new connection, sign in with your Intershop Customer Service Portal login and add the MCP tool to your agent.

8. Test the agent with the question from section Verify the Connection.

For details, see Microsoft | Connect your agent to an existing MCP server and Microsoft | Extend your agent with Model Context Protocol.

After testing, publish the agent to the corresponding channel. The agent is then available in Teams or Microsoft 365 Copilot. Ensure that your tenant has the required licenses and permissions.

Other MCP Clients

In a client or IDE plugin that supports remote MCP servers over Streamable HTTP, add the server URL and name shown above. The client must support OAuth sign-in for remote MCP servers. Sign in with your Intershop Customer Service Portal login when prompted. Then enable the tools as described in the client’s documentation. Configuration files and menu names differ between clients. Copy the VS Code JSON only into clients that support this format.

Intershop tested the connection only with GitHub Copilot in Visual Studio Code and with Claude Code. Other MCP clients may work as well but have not been tested by Intershop.

Verify the Connection

Ask your AI assistant:

Use the intershop-docs MCP tools to find documentation on creating a custom shipping condition in ICM 14. Summarize the approach and include the source links. Do not change any files.

Verify the following in the response:

• The client shows a tool call to intershop-docs.

• The call returns content without a connection error.

• The answer includes the retrieved sources.

Only an answer that includes a tool call verifies the connection.

For subsequent questions, include the product, the version, and the relevant error message or task. Review the source articles and the generated code before applying any changes.

Optional: Add Documentation Lookup to Your Workflow

Add the following instruction to the CLAUDE.md file or the .github/copilot-instructions.md file of your project:

Before suggesting or changing Intershop-specific code, use the intershop-docs
MCP tools to consult relevant documentation and fixed issues for the target
product and version. Include source links and state when no matching
documentation was found.

Troubleshooting

For unresolved access issues, contact Intershop Customer Support or the Intershop Partner Team.