hakgyo

Hakgyo for Claude and ChatGPT

Hakgyo is a course platform for Korean language schools and teachers. Its connector lets Claude and ChatGPT work with your Hakgyo account: teachers and school administrators can run their classes from a conversation, and learners can read their course outline. The connector is a remote MCP server at https://hakgyo.id/api/mcp.

What you can do

  • Plan courses: create courses, add and reorder modules, and arrange lessons in order.
  • Write materials: create lesson materials such as grammar explanations and example dialogues, and add them to a module.
  • Build vocabulary: create kosakata sets with Korean words, meanings and example sentences.
  • Create Tugas and quizzes: author assignments with multiple-choice and written questions.
  • Review submissions: see which learner attempts are waiting for review, read the written answers, and score them.
  • Run study groups: create study groups, manage enrollments, and schedule meetings.
  • Manage your school: list members and roles, and read organization analytics.
  • For learners: list your courses, read the outline, materials and vocabulary, and mark an item as started or finished.

What it does not do

  • Learners take Tugas in the Hakgyo mobile app. The connector never shows the questions or submits answers for a learner. When a learner asks about a Tugas, Claude only shares a link that opens it in the app.
  • Nothing is bought or sold through the connector. A course price is what learners pay the school inside Hakgyo.
  • It cannot see or change anything your role in a school does not allow.

Connect from Claude

You need a Hakgyo account. Teachers and administrators sign in with the account they use for their school workspace.

  • Claude on the web, desktop and mobile: open Customize > Connectors, choose to add a custom connector, and enter https://hakgyo.id/api/mcp. Select Connect, sign in to Hakgyo, and choose Allow on the consent screen.
  • Claude Code: run the command below, then use /mcp to sign in.
claude mcp add --transport http hakgyo https://hakgyo.id/api/mcp

In a chat, turn the Hakgyo connector on from the + menu, then ask for what you need.

Connect from ChatGPT

Add https://hakgyo.id/api/mcp as a custom MCP server in ChatGPT under Plugins, choose OAuth, and sign in to Hakgyo when asked.

Try these prompts

  • Which Hakgyo organizations am I part of and what is my role?
  • Add a module called Greetings to my Korean Basics 1 course.
  • Create a material explaining 안녕하세요 and 감사합니다 with an example dialogue, and add it to the Greetings module.
  • Make a vocabulary set called Basic Greetings with five common greetings and their Indonesian meanings.
  • Which Tugas attempts are waiting for my review?

Sign-in and permissions

  • Sign-in uses OAuth 2.1 with PKCE. Claude and ChatGPT never see your password, and you approve the connection on a Hakgyo consent screen.
  • The connector asks for a single scope, hakgyo:mcp. The scope only opens the connection. Every action is checked against your current role and membership in Hakgyo at the moment you use it.
  • Access tokens last 15 minutes and are renewed with a rotating refresh token.
  • To disconnect, remove the Hakgyo connector in Claude or ChatGPT. The connection stops working as soon as it is removed.

Safety

  • Tools that only read are marked read-only. Tools that change or publish data are marked as such, so Claude asks for your approval before running them.
  • Publishing a course, changing a member's role, cancelling an enrollment and saving review scores are confirmed with you first.
  • Results exclude secrets and internal identifiers such as storage keys and Zoom ids.

Data we send to Claude and ChatGPT

The connector returns only the results of the tools you ask Claude or ChatGPT to run, for example your course outline or a list of attempts waiting for review. See the Privacy Policy for how Hakgyo handles personal data.

Troubleshooting

  • Sign-in does not finish: remove the connector, add it again, and sign in with the same Hakgyo account that belongs to your school.
  • Permission denied: your role in that school does not allow the action. Ask a school owner or administrator.
  • Nothing appears: check that the connector is turned on for the conversation from the + menu.

Support

Email rorezxez@gmail.com with your account email, the school name and what you asked Claude or ChatGPT to do. More help is on the support page.